Release Apps

Use this path when you want to publish application artifacts rather than npm packages.

This repository currently ships two app release types:

• Chrome extension zip
• VSCode extension VSIX

If the target is @modeldriveprotocol/browser-simple-mdp-client, do not use this page. That app is published through the npm package release track instead of a dedicated artifact-release workflow.

Chrome extension

Use this path when you want a packaged Chrome extension zip attached to a GitHub release and, when repository credentials are configured, submitted to the Chrome Web Store.

Operator steps

1. Update apps/chrome-extension/package.json to the release version.
2. Create and push a tag like chrome-extension-v1.0.0.
3. GitHub Actions runs .github/workflows/chrome-extension-release.yml.

What the workflow checks

• the tag version matches package.json
• the generated WXT manifest version matches package.json

What the workflow does

• typechecks and tests the extension
• builds shared workspace package dependencies needed for bundling
• builds the Chrome extension
• packages apps/chrome-extension/dist/chrome-mv3 into a zip
• uploads the packaged artifact inside the workflow
• refreshes an OAuth access token for the Chrome Web Store API when repository credentials are configured
• uploads the zip to the configured Chrome Web Store item and submits it for publishing
• creates or updates a GitHub release for the tag and attaches the zip

VSCode extension

Use this path when you want to publish a VSIX to the VS Code Marketplace and also attach it to a GitHub release.

Operator steps

1. Update apps/vscode-extension/package.json to the release version.
2. Create and push a tag like vscode-extension-v1.0.0.
3. GitHub Actions runs .github/workflows/vscode-extension-release.yml.

What the workflow checks

• the tag version matches apps/vscode-extension/package.json
• repository variable VSCODE_EXTENSION_PUBLISHER is present

What the workflow does

• typechecks and tests the extension
• builds shared workspace package dependencies needed for bundling
• builds the VSCode extension
• packages a .vsix
• uploads the .vsix as a workflow artifact
• publishes the .vsix to the VS Code Marketplace
• creates or updates a GitHub release for the tag and attaches the .vsix

Required repository setup

• repository variable CHROME_WEB_STORE_EXTENSION_ID
• repository variable CHROME_WEB_STORE_PUBLISHER_ID
• secret CHROME_WEB_STORE_CLIENT_ID
• secret CHROME_WEB_STORE_CLIENT_SECRET
• secret CHROME_WEB_STORE_REFRESH_TOKEN
• repository variable VSCODE_EXTENSION_PUBLISHER
• secret VSCE_PAT

Local validation before tagging

pnpm --filter @modeldriveprotocol/chrome-extension typecheck
pnpm --filter @modeldriveprotocol/chrome-extension test
pnpm --filter @modeldriveprotocol/protocol build
pnpm --filter @modeldriveprotocol/client build
pnpm --filter @modeldriveprotocol/chrome-extension build

pnpm --filter @modeldriveprotocol/vscode-extension typecheck
pnpm --filter @modeldriveprotocol/vscode-extension test
pnpm --filter @modeldriveprotocol/protocol build
pnpm --filter @modeldriveprotocol/client build
pnpm --filter @modeldriveprotocol/vscode-extension build