Skip to content

MARKETPLACE.md

Latest commit

 

History

History
108 lines (80 loc) · 2.98 KB

MARKETPLACE.md

File metadata and controls

108 lines (80 loc) · 2.98 KB

Publishing to VS Code Marketplace

Prerequisites

  1. Microsoft Account: You need a Microsoft account to create a publisher
  2. Azure DevOps Account: Create one at https://dev.azure.com
  3. Personal Access Token (PAT): Required for publishing

Step 1: Create a Publisher

  1. Go to https://marketplace.visualstudio.com/manage
  2. Sign in with your Microsoft account
  3. Click Create publisher
  4. Fill in the details:
    • Publisher ID: wasted-potential-studios (must match package.json)
    • Display Name: Wasted Potential Studios
    • Description: Your studio description
  5. Click Create

Step 2: Get a Personal Access Token

  1. Go to https://dev.azure.com
  2. Click your profile icon (top right) → Personal access tokens
  3. Click + New Token
  4. Fill in:
    • Name: vscode-marketplace
    • Organization: All accessible organizations
    • Expiration: Set to your preference
    • Scopes: Click "Show all scopes" and select:
      • ✅ Marketplace → Manage (this is required!)
  5. Click Create
  6. COPY THE TOKEN (you can't see it again!)

Step 3: Login to vsce

Open terminal and run:

vsce login wasted-potential-studios

When prompted, paste your Personal Access Token.

Step 4: Publish

Before publishing, make sure to:

  1. Add repository URL to package.json (replace YOUR_USERNAME):

    "repository": {
    "type": "git",
    "url": "https://github.com/YOUR_USERNAME/swg-stf-editor"
}

  2. Create an icon (128x128 PNG) named icon.png in the extension root

  3. Test the extension thoroughly in VS Code

Then publish with:

cd "c:\Users\Joseph Ridder\Documents\SWG-Source\swg-stf-editor-extension"
vsce publish

Step 5: Verify

  1. Go to https://marketplace.visualstudio.com/manage/publishers/wasted-potential-studios
  2. Your extension should appear in the list
  3. It may take a few minutes to be publicly available
  4. Test installation: code --install-extension wasted-potential-studios.swg-stf-editor

Updating the Extension

When you need to publish updates:

  1. Update version in package.json: 
    vsce publish patch   # 1.0.0 → 1.0.1
vsce publish minor   # 1.0.0 → 1.1.0
vsce publish major   # 1.0.0 → 2.0.0

Or manually:

vsce publish 1.0.1

Notes

  • First publication may take up to 24 hours for review
  • Subsequent updates are usually instant
  • Extension name must be unique in the marketplace
  • Publisher name cannot be changed after creation
  • Keep your PAT secure and never commit it to git

Troubleshooting

"Missing repository" error

Add repository field to package.json or use --allow-missing-repository flag

"Missing publisher" error

Make sure publisher in package.json matches your marketplace publisher ID

"Missing icon" error

Add a 128x128 PNG icon named icon.png or remove icon field from package.json

"Authentication failed"

Re-run vsce login wasted-potential-studios with a fresh PAT