velxio/vscode-extension
davidmonterocrespo24 201d414aa7 feat(vscode-extension): 0.2.0 — Pro license gate + deep-link sign-in
Adds the Velxio Pro subscription gate to the VS Code extension. Every
compile / run validates against `https://velxio.dev/api/pro/license/validate`
before proceeding; a 60-second in-memory cache avoids hammering the
endpoint during a tight compile/run loop. No offline mode by design —
the extension throws OfflineError on network failure rather than
caching a permission grant locally. For offline workflows users get
the desktop app (separate distribution channel).

New surface:

  - `LicenseService` (src/LicenseService.ts) — secret-store-backed key
    storage, validate, nonce-backed deep-link OAuth handshake,
    OfflineError + EntitlementError taxonomy.
  - `Velxio: Sign In`              — opens velxio.dev/auth/vscode, returns
                                     via vscode://velxio.velxio-simulator/auth.
  - `Velxio: Paste License Key`    — manual fallback for headless boxes.
  - `Velxio: Sign Out`             — clears the keychain entry.
  - `Velxio: Show License Status`  — plan + trial countdown modal.
  - Status bar item: Sign in / Trial Nd / Pro / Trial ended with the
    appropriate warning/error background colour.
  - Setting `velxio.licenseApiBase` for staging overrides.

CHANGELOG.md + README.md added.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-21 04:51:07 +02:00
..
media
…
schemas
…
src feat(vscode-extension): 0.2.0 — Pro license gate + deep-link sign-in 2026-05-21 04:51:07 +02:00
webview
…
CHANGELOG.md feat(vscode-extension): 0.2.0 — Pro license gate + deep-link sign-in 2026-05-21 04:51:07 +02:00
LICENSE
…
README.md feat(vscode-extension): 0.2.0 — Pro license gate + deep-link sign-in 2026-05-21 04:51:07 +02:00
package-lock.json feat(vscode-extension): 0.2.0 — Pro license gate + deep-link sign-in 2026-05-21 04:51:07 +02:00
package.json feat(vscode-extension): 0.2.0 — Pro license gate + deep-link sign-in 2026-05-21 04:51:07 +02:00
tsconfig.json
…
velxio-simulator-0.1.0.vsix
…

README.md

Velxio Simulator for VS Code

Local Arduino, RP2040 and ESP32 simulator inside your editor. Compile your sketch, watch it run in a side-by-side WebView, and stream serial to the integrated terminal — no board, no USB cable, no separate IDE.

Requirements

  • VS Code 1.85 or newer.
  • A Velxio Pro subscription. A 30-day free trial is included and starts automatically the first time you sign in.
  • An internet connection. The extension validates your subscription before every compile and run; offline use is not supported in the VS Code build. For offline work, use the Velxio Desktop app instead.

Getting started

  1. Install the extension from the marketplace.
  2. Open a folder containing velxio.toml or diagram.json (or create one with Velxio: Open Simulator).
  3. Run Velxio: Sign In from the command palette. Your browser opens https://velxio.dev/auth/vscode; sign in (or create an account), then click Authorise VS Code. The page hands a license token back to VS Code via the vscode://velxio.velxio-simulator/auth URI scheme.
  4. The status bar in the bottom-left shows Velxio: Trial 30d (or Velxio: Pro for paid subscribers). Compile and Run are now enabled.

If your browser blocks the deep-link, or if you'd rather paste the key manually, run Velxio: Paste License Key and enter the vlx_pro_... / vlx_trial_... string from Account → My licenses.

Commands

Command Description
Velxio: Open Simulator Open the side-by-side simulator panel.
Velxio: Compile Sketch Build the active project (requires Pro).
Velxio: Run Simulation Compile and start the simulation.
Velxio: Stop Simulation Stop the current simulation.
Velxio: Select Board Pick the target board (Arduino Uno, RP2040, ESP32, …).
Velxio: Sign In Browser-based sign-in via velxio.dev.
Velxio: Paste License Key Paste a key manually.
Velxio: Sign Out Forget the stored key.
Velxio: Show License Status Show plan, trial countdown, renewal date.

Settings

Setting Default Description
velxio.defaultBoard arduino-uno Board used when none is configured in velxio.toml.
velxio.autoStartBackend true Auto-start the local compilation backend when needed.
velxio.backendPort 0 Fixed port for the backend (0 = auto-assign).
velxio.arduinoCliPath "" Path to arduino-cli (leave empty to auto-detect).
velxio.licenseApiBase https://velxio.dev License validation endpoint. Override only for development.

Pricing

  • Free trial — 30 days, full Velxio Pro features, no credit card.
  • Pro $15/mo — unlocks the VS Code extension, the Velxio Desktop app, and the premium components on velxio.dev.
  • Pro Max $35/mo — everything in Pro plus the in-app AI assistant and priority simulation queue.

Manage your subscription at https://velxio.dev/billing.

Troubleshooting

  • Velxio requires an internet connection — the extension cannot reach https://velxio.dev/api/pro/license/validate. Check your network, VPN, and any corporate proxy.
  • Your trial has ended — start a Pro subscription at https://velxio.dev/billing. Existing trial keys re-activate automatically once the subscription is live.
  • Status bar shows Velxio: Sign in — run Velxio: Sign In or Velxio: Paste License Key.
  • Deep-link doesn't return to VS Code — some browsers silently block custom URL schemes. The page shows an Open VS Code button as a fallback; click it to retry the deep-link.

Privacy

The extension sends only your license key + your VS Code version + OS arch to https://velxio.dev for validation. No sketch contents, file paths, or telemetry leave your machine. See the Velxio privacy policy for the full picture.