# codesandbox/codesandbox-client architecture

> Architecture diagram of the GitHub repository codesandbox/codesandbox-client, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/codesandbox/codesandbox-client
- Repository: https://github.com/codesandbox/codesandbox-client

## Overview

CodeSandbox Client is the browser-based online IDE described in the README. Its principal workflow is to create or import a project, edit and run code in a sandbox, then share the result. The tree also shows dashboard, workspace setup, notifications, and checkout capabilities. Sandpack’s manager coordinates module resolution, dependency retrieval, and transpilation; BrowserFS and Monaco/TypeScript provide supporting runtime and editor facilities. App-level wiring and several subsystems were not sampled, so those connections are shown as unverified rather than asserted as source-confirmed calls.

Main entry points: [`packages/app/src/app/components/CodeEditor`](https://github.com/codesandbox/codesandbox-client/tree/main/packages/app/src/app/components/CodeEditor) (Code editor UI), [`packages/sandpack-core/src/manager.ts`](https://github.com/codesandbox/codesandbox-client/blob/main/packages/sandpack-core/src/manager.ts) (Module manager), [`packages/app/src/app/components/Create`](https://github.com/codesandbox/codesandbox-client/tree/main/packages/app/src/app/components/Create) (Create or import), [`packages/sandpack-core/src/npm/dynamic/fetch-npm-module.ts`](https://github.com/codesandbox/codesandbox-client/blob/main/packages/sandpack-core/src/npm/dynamic/fetch-npm-module.ts) (Dependency fetch)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_project["Project onboarding"]
  node_create["Create or import"]
  node_dashboard["Project dashboard"]
  node_workspace["Workspace setup"]
end

subgraph group_ide["IDE experience"]
  node_editor_ui["Code editor UI"]
  node_preview["Preview and devtools"]
  node_sharing["Share project<br/>[SandboxEmbed.tsx]"]
end

subgraph group_execution["Sandbox execution"]
  node_manager["Module manager<br/>[manager.ts]"]
  node_npm_fetch["Dependency fetch"]
  node_protocols["Fetch protocols<br/>[index.ts]"]
  node_resolver["Module resolver<br/>[resolver.ts]"]
  node_transpiled["Transpiled modules"]
  node_browserfs["Browser file system<br/>[file_system.ts]"]
  node_localstorage[("LocalStorage backend<br/>[LocalStorage.ts]")]
  node_workerfs["WorkerFS backend<br/>[WorkerFS.ts]"]
end

subgraph group_platform["Client platform"]
  node_state["Application state"]
  node_graphql["GraphQL client<br/>[client.ts]"]
end

subgraph group_editor["Editor services"]
  node_typescript_worker["TypeScript worker<br/>[tsWorker.ts]"]
  node_worker_manager["Worker manager<br/>[workerManager.ts]"]
  node_textmate["TextMate grammar<br/>[main.ts]"]
end

node_user(("Developer"))
node_api{{"CodeSandbox API"}}

node_user -.->|"starts project"| node_create
node_create -.->|"opens project"| node_dashboard
node_user -.->|"manages projects"| node_dashboard
node_dashboard -.->|"configures workspace"| node_workspace
node_user -.->|"edits code"| node_editor_ui
node_editor_ui -.->|"runs project"| node_preview
node_preview -.->|"shares creation"| node_sharing
node_editor_ui -.->|"supplies modules"| node_manager
node_manager -->|"resolves paths"| node_resolver
node_manager -->|"transpiles modules"| node_transpiled
node_manager -->|"loads dependencies"| node_npm_fetch
node_npm_fetch -->|"selects protocol"| node_protocols
node_npm_fetch -->|"resolves package"| node_resolver
node_manager -.->|"provides modules"| node_preview
node_state -.->|"uses client"| node_graphql
node_graphql -.->|"queries API"| node_api
node_create -.->|"queries repositories"| node_api
node_worker_manager -->|"creates worker"| node_typescript_worker
node_typescript_worker -->|"configures filesystem"| node_browserfs
node_browserfs -.->|"backs filesystem"| node_localstorage
node_browserfs -.->|"provides backend"| node_workerfs
node_editor_ui -.->|"requests language service"| node_worker_manager
node_editor_ui -.->|"uses grammar highlighting"| node_textmate

click node_create "https://github.com/codesandbox/codesandbox-client/tree/main/packages/app/src/app/components/Create"
click node_dashboard "https://github.com/codesandbox/codesandbox-client/tree/main/packages/app/src/app/pages/Dashboard"
click node_workspace "https://github.com/codesandbox/codesandbox-client/tree/main/packages/app/src/app/components/WorkspaceSetup"
click node_editor_ui "https://github.com/codesandbox/codesandbox-client/tree/main/packages/app/src/app/components/CodeEditor"
click node_preview "https://github.com/codesandbox/codesandbox-client/tree/main/packages/app/src/app/components/Preview"
click node_sharing "https://github.com/codesandbox/codesandbox-client/blob/main/packages/react-embed/src/SandboxEmbed/SandboxEmbed.tsx"
click node_manager "https://github.com/codesandbox/codesandbox-client/blob/main/packages/sandpack-core/src/manager.ts"
click node_npm_fetch "https://github.com/codesandbox/codesandbox-client/blob/main/packages/sandpack-core/src/npm/dynamic/fetch-npm-module.ts"
click node_protocols "https://github.com/codesandbox/codesandbox-client/blob/main/packages/sandpack-core/src/npm/dynamic/fetch-protocols/index.ts"
click node_resolver "https://github.com/codesandbox/codesandbox-client/blob/main/packages/sandpack-core/src/resolver/resolver.ts"
click node_transpiled "https://github.com/codesandbox/codesandbox-client/blob/main/packages/sandpack-core/src/transpiled-module/transpiled-module.ts"
click node_browserfs "https://github.com/codesandbox/codesandbox-client/blob/main/standalone-packages/codesandbox-browserfs/src/core/file_system.ts"
click node_localstorage "https://github.com/codesandbox/codesandbox-client/blob/main/standalone-packages/codesandbox-browserfs/src/backend/LocalStorage.ts"
click node_workerfs "https://github.com/codesandbox/codesandbox-client/blob/main/standalone-packages/codesandbox-browserfs/src/backend/WorkerFS.ts"
click node_state "https://github.com/codesandbox/codesandbox-client/tree/main/packages/app/src/app/overmind"
click node_graphql "https://github.com/codesandbox/codesandbox-client/blob/main/packages/app/src/app/graphql/client.ts"
click node_typescript_worker "https://github.com/codesandbox/codesandbox-client/blob/main/standalone-packages/monaco-typescript/src/tsWorker.ts"
click node_worker_manager "https://github.com/codesandbox/codesandbox-client/blob/main/standalone-packages/monaco-typescript/src/workerManager.ts"
click node_textmate "https://github.com/codesandbox/codesandbox-client/blob/main/standalone-packages/vscode-textmate/src/main.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_create,node_dashboard,node_workspace toneBlue
class node_editor_ui,node_preview,node_sharing toneAmber
class node_manager,node_npm_fetch,node_protocols,node_resolver,node_transpiled,node_browserfs,node_localstorage,node_workerfs,node_api toneMint
class node_state,node_graphql toneRose
class node_typescript_worker,node_worker_manager,node_textmate,node_user toneIndigo
```

## Components

### Project onboarding

- [Create or import](https://github.com/codesandbox/codesandbox-client/tree/main/packages/app/src/app/components/Create): `packages/app/src/app/components/Create`
- [Project dashboard](https://github.com/codesandbox/codesandbox-client/tree/main/packages/app/src/app/pages/Dashboard): `packages/app/src/app/pages/Dashboard`
- [Workspace setup](https://github.com/codesandbox/codesandbox-client/tree/main/packages/app/src/app/components/WorkspaceSetup): `packages/app/src/app/components/WorkspaceSetup`

### IDE experience

- [Code editor UI](https://github.com/codesandbox/codesandbox-client/tree/main/packages/app/src/app/components/CodeEditor): `packages/app/src/app/components/CodeEditor`
- [Preview and devtools](https://github.com/codesandbox/codesandbox-client/tree/main/packages/app/src/app/components/Preview): `packages/app/src/app/components/Preview`
- [Share project](https://github.com/codesandbox/codesandbox-client/blob/main/packages/react-embed/src/SandboxEmbed/SandboxEmbed.tsx): `packages/react-embed/src/SandboxEmbed/SandboxEmbed.tsx`

### Sandbox execution

- [Module manager](https://github.com/codesandbox/codesandbox-client/blob/main/packages/sandpack-core/src/manager.ts): `packages/sandpack-core/src/manager.ts`
- [Dependency fetch](https://github.com/codesandbox/codesandbox-client/blob/main/packages/sandpack-core/src/npm/dynamic/fetch-npm-module.ts): `packages/sandpack-core/src/npm/dynamic/fetch-npm-module.ts`
- [Fetch protocols](https://github.com/codesandbox/codesandbox-client/blob/main/packages/sandpack-core/src/npm/dynamic/fetch-protocols/index.ts): `packages/sandpack-core/src/npm/dynamic/fetch-protocols/index.ts`
- [Module resolver](https://github.com/codesandbox/codesandbox-client/blob/main/packages/sandpack-core/src/resolver/resolver.ts): `packages/sandpack-core/src/resolver/resolver.ts`
- [Transpiled modules](https://github.com/codesandbox/codesandbox-client/blob/main/packages/sandpack-core/src/transpiled-module/transpiled-module.ts): `packages/sandpack-core/src/transpiled-module/transpiled-module.ts`
- [Browser file system](https://github.com/codesandbox/codesandbox-client/blob/main/standalone-packages/codesandbox-browserfs/src/core/file_system.ts): `standalone-packages/codesandbox-browserfs/src/core/file_system.ts`
- [LocalStorage backend](https://github.com/codesandbox/codesandbox-client/blob/main/standalone-packages/codesandbox-browserfs/src/backend/LocalStorage.ts): `standalone-packages/codesandbox-browserfs/src/backend/LocalStorage.ts`
- [WorkerFS backend](https://github.com/codesandbox/codesandbox-client/blob/main/standalone-packages/codesandbox-browserfs/src/backend/WorkerFS.ts): `standalone-packages/codesandbox-browserfs/src/backend/WorkerFS.ts`

### Client platform

- [Application state](https://github.com/codesandbox/codesandbox-client/tree/main/packages/app/src/app/overmind): `packages/app/src/app/overmind`
- [GraphQL client](https://github.com/codesandbox/codesandbox-client/blob/main/packages/app/src/app/graphql/client.ts): `packages/app/src/app/graphql/client.ts`

### Editor services

- [TypeScript worker](https://github.com/codesandbox/codesandbox-client/blob/main/standalone-packages/monaco-typescript/src/tsWorker.ts): `standalone-packages/monaco-typescript/src/tsWorker.ts`
- [Worker manager](https://github.com/codesandbox/codesandbox-client/blob/main/standalone-packages/monaco-typescript/src/workerManager.ts): `standalone-packages/monaco-typescript/src/workerManager.ts`
- [TextMate grammar](https://github.com/codesandbox/codesandbox-client/blob/main/standalone-packages/vscode-textmate/src/main.ts): `standalone-packages/vscode-textmate/src/main.ts`

### Other components

- **Developer**
- **CodeSandbox API**

## Connections

- Developer → Create or import: starts project
- Create or import → Project dashboard: opens project
- Developer → Project dashboard: manages projects
- Project dashboard → Workspace setup: configures workspace
- Developer → Code editor UI: edits code
- Code editor UI → Preview and devtools: runs project
- Preview and devtools → Share project: shares creation
- Code editor UI → Module manager: supplies modules
- Module manager → Module resolver: resolves paths (evidence: `packages/sandpack-core/src/manager.ts`)
- Module manager → Transpiled modules: transpiles modules (evidence: `packages/sandpack-core/src/manager.ts`)
- Module manager → Dependency fetch: loads dependencies (evidence: `packages/sandpack-core/src/manager.ts`)
- Dependency fetch → Fetch protocols: selects protocol (evidence: `packages/sandpack-core/src/npm/dynamic/fetch-npm-module.ts`)
- Dependency fetch → Module resolver: resolves package (evidence: `packages/sandpack-core/src/npm/dynamic/fetch-npm-module.ts`)
- Module manager → Preview and devtools: provides modules
- Application state → GraphQL client: uses client
- GraphQL client → CodeSandbox API: queries API
- Create or import → CodeSandbox API: queries repositories
- Worker manager → TypeScript worker: creates worker (evidence: `standalone-packages/monaco-typescript/src/workerManager.ts`)
- TypeScript worker → Browser file system: configures filesystem (evidence: `standalone-packages/monaco-typescript/src/tsWorker.ts`)
- Browser file system → LocalStorage backend: backs filesystem (evidence: `standalone-packages/codesandbox-browserfs/src/backend/LocalStorage.ts`)
- Browser file system → WorkerFS backend: provides backend (evidence: `standalone-packages/codesandbox-browserfs/src/backend/WorkerFS.ts`)
- Code editor UI → Worker manager: requests language service
- Code editor UI → TextMate grammar: uses grammar highlighting
