← Docs/Recipe
Recipe

VS Code Workspace Config

A single .code-workspace file that ties together settings, extensions, and launch configs so every developer on the team shares the same environment.

Why a workspace file?

  • One-click open for multi-root repos.
  • Recommended extensions enforced for the team.
  • Shared debug and task configurations.
  • Editor settings scoped to the project.

Minimal example

{
  "folders": [
    { "path": "packages/api" },
    { "path": "packages/web" }
  ],
  "settings": {
    "editor.formatOnSave": true,
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },
  "extensions": {
    "recommendations": [
      "esbenp.prettier-vscode",
      "dbaeumer.vscode-eslint"
    ]
  }
}

Launch configs

Add a launch section inside settings to attach the Node debugger or run a compound configuration across multiple services.

"launch": {
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "API",
      "cwd": "${workspaceFolder:api}",
      "runtimeExecutable": "pnpm",
      "runtimeArgs": ["dev"]
    }
  ]
}

Check it in

Commit meridian.code-workspace to the repo root. Teammates open it with File → Open Workspace from File.

Need the full reference? Browse the docs index for workspace schema details and multi-root debugging guides.