VS Code Extension

Use Apployd from the VS Code Extension

Connect VS Code to Apployd so you can review organizations, projects, deployments, and logs without leaving the editor.

What the extension is for

The Apployd VS Code extension gives operators a native sidebar for account context, project visibility, deployment actions, and log access from inside the editor.

It is designed for day-to-day operational work such as checking deployment status, starting a new release, canceling a risky rollout, or opening the dashboard for deeper inspection.

  • Overview view for account and organization context.
  • Projects view for project details and inline actions.
  • Deployments view for recent releases and status inspection.
  • Command Palette actions for sign in, refresh, deploy, cancel, logs, and dashboard links.

Initial setup

After installing the extension in VS Code, open the Apployd activity bar entry to load the Overview, Projects, and Deployments views.

The default configuration targets the hosted Apployd control plane, but teams running a local or self-hosted environment should override the API and dashboard base URLs in VS Code settings.

  • apployd.apiBaseUrl defaults to https://apployd.com/api/v1.
  • apployd.dashboardBaseUrl defaults to https://apployd.com.
  • For local development use http://localhost:4000/api/v1 and http://localhost:3000.

Sign in and organization selection

Use Apployd: Sign In from the sidebar or Command Palette, enter your email and password, and complete email verification if the login flow requires a one-time code.

Once authenticated, select the working organization so project and deployment views load the correct workspace context.

  • Authentication tokens are stored in VS Code SecretStorage rather than plain settings.
  • Use Apployd: Select Organization whenever you need to switch workspace context.
  • Use Apployd: Sign Out to clear the stored session from the extension.

Daily workflow inside VS Code

The Overview view gives a quick operational snapshot, including the signed-in account, selected organization, project count, and recent deployment count.

The Projects and Deployments views provide the primary release workflow: choose a project, deploy to production or preview, inspect recent history, copy deployment identifiers, cancel in-progress deployments, and fetch project logs into the output panel.

  • Use Projects to inspect branch, runtime, and target port for each project.
  • Use Deploy Now to queue a production or preview deployment with optional branch and commit overrides.
  • Use Show Logs to open the latest project logs in the Apployd output channel.
  • Use Deployments to review recent release status and cancel in-progress runs when necessary.
  • Use Open Project Dashboard or Open Dashboard when you need the full web interface.

Current scope

The extension currently focuses on operational visibility and common deployment actions rather than full project administration.

Teams should still use the dashboard for broader setup flows such as project creation, secret management, and other advanced platform features not yet exposed in the extension.

This extension is currently an MVP. Treat it as an operator workflow surface, not a complete replacement for the dashboard.