DocsDashboardWorkspaces

Workspaces

Workspaces are the containers for your projects. They link your Git repositories to GRID and define the development environment. When you open GRID IDE, your workspaces appear in the project explorer.

Creating a Workspace

1
Navigate to Dashboard → Workspaces
2
Click New Workspace
3
Enter a name for your workspace
4
Provide the Repository URL (GitHub, GitLab, etc.)
5
Specify the default branch (usually main or master)
6
Click Create Workspace

Environment Configuration

GRID automatically detects your project type (Node.js, Python, Rust, etc.) and configures the environment. You can override this by adding a grid.json to your repository root.

Example grid.json

{
  "image": "node:18",
  "extensions": [
    "dbaeumer.vscode-eslint",
    "esbenp.prettier-vscode"
  ],
  "onCreateCommand": "npm install",
  "ports": [3000]
}

Auto-Detection

GRID analyzes your repository to detect frameworks, package managers, and build tools automatically.

Custom Configuration

Override defaults with grid.json for custom Docker images, extensions, and startup commands.

Syncing with IDE

When you open GRID IDE, your workspaces appear in the project explorer. Clicking a workspace instantly clones the repo and sets up the environment based on your configuration.

Workspaces sync automatically between Dashboard and IDE
One-click workspace switching in the IDE
Isolated environments per workspace
Shared secrets and agents across all workspaces

Deleting a Workspace

Deleting a workspace removes the configuration from GRID but does not delete your Git repository or any remote data.

All local files and settings associated with the workspace will be removed from your IDE, but your remote repository remains untouched.