Development

May 10, 2026 · View on GitHub

Requirements

  • Node.js 20+
  • VS Code 1.107.0+

Install

npm install

Build

npm run compile

Typecheck

npm run typecheck

Test

npm test

Coverage

npm run test:coverage

Run in VS Code

  • Press F5 to launch the Extension Development Host.

Package

npm run package

The generated VSIX is written to dist/forgeflow-<version>.vsix.

Publishing (Marketplace)

Prerequisites

  • VS Code Marketplace publisher created with publisher id EvotecServices.
  • Marketplace PAT stored as the GitHub organization or repository secret VSCE_PAT.
  • The PAT needs the Azure DevOps Marketplace Manage scope.
  • package.json must keep "publisher": "EvotecServices" so the extension lands under the correct publisher.

Package locally

# Build, lint, typecheck, test, and package
./publish.ps1

# Skip the slower parts when the workspace is already validated
./publish.ps1 -SkipNpmCi -SkipTests

Publish locally

$env:VSCE_PAT = '<marketplace-pat>'
./publish.ps1 -Publish -PreRelease

Equivalent npm scripts:

npm run publish:local
npm run publish:marketplace:pre

Publish from GitHub Actions

Use the Publish VS Code Extension workflow.

  1. Run it from master.
  2. Keep pre_release checked for early Marketplace builds.
  3. Check publish_marketplace only when the VSIX should be pushed to Marketplace.

The workflow always uploads the packaged VSIX as an artifact. Marketplace publishing is branch-guarded to master.

Publish from a GitHub Release

Publishing a GitHub Release named v<version> or forgeflow-v<version> publishes that version to the Visual Studio Marketplace and attaches the packaged VSIX to the release. The release tag must match package.json and point to a commit contained in master.

Mark the GitHub Release as pre-release to publish a VS Code pre-release build. Normal GitHub Releases publish normal Marketplace builds.

Verified Publisher

Marketplace verification is handled by Microsoft. Use the Marketplace publisher settings to:

  • Set display name to "Evotec Services".
  • Verify your domain and request a verified publisher badge.

Dev install (Insiders)

See README for the dev link install steps. For WSL → Windows Insiders one-shot install:

npm run install:insiders

Windows PowerShell:

npm run install:insiders:ps