VS Code Extension
Start, stop, and restart the Jamdesk dev server from the Visual Studio Code status bar with one-click controls and auto browser preview.
Preview your documentation without leaving Visual Studio Code. The Jamdesk extension adds a status bar button that starts jamdesk dev. It watches the server and opens your browser when the server is ready.
Prerequisites
- Jamdesk CLI installed (
npm install -g jamdesk) - A workspace containing a
docs.jsonfile
Install the Extension
Search for Jamdesk in the VS Code Extensions panel (Cmd+Shift+X on macOS, Ctrl+Shift+X on Windows/Linux) and click Install. Or install from the VS Code Marketplace.
The extension activates in a workspace that contains a docs.json file. A play button appears in the status bar.
Start the Dev Server
Click the play button in the status bar. The extension:
- Spawns
jamdesk devas a child process - Monitors output to detect when the server is ready
- Opens your browser to the local preview (if auto-open is enabled)
The status bar shows the current server state: starting, running, or stopped.
Commands
Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and type "Jamdesk":
| Command | Description |
|---|---|
| Jamdesk: Start Dev Server | Start the dev server |
| Jamdesk: Stop Dev Server | Stop the running server |
| Jamdesk: Restart Dev Server | Restart the server |
| Jamdesk: Show Output | Reveal the CLI output channel |
Settings
Configure the extension in VS Code settings (Cmd+, / Ctrl+,) under Jamdesk:
| Setting | Default | Description |
|---|---|---|
jamdesk.port | 3000 | Preferred dev server port |
jamdesk.verbose | false | Enable verbose CLI output |
jamdesk.clean | false | Clear build cache on next start |
jamdesk.browserMode | external | Where to open preview: external (system browser) or embedded (VS Code side panel) |
jamdesk.autoOpenBrowser | true | Open browser when server is ready |
Set browserMode to embedded to open the docs preview in a VS Code side panel. Edit and preview side by side.
Smart Port Handling
The CLI moves to the next free port when your preferred port is taken. The extension reads the port from the CLI output. The browser opens to the correct URL.
Output Channel
The extension streams CLI output to a Jamdesk output channel. Open it with the Jamdesk: Show Output command or from the Output panel dropdown.
Use it to:
- Monitor build progress
- Debug server issues
- View verbose logs (when
jamdesk.verboseis enabled)