How codesandbox/codesandbox-client works
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: CodeEditor Code editor UI · manager.ts Module manager · Create Create or import · fetch-npm-module.ts Dependency fetch
Components 21
Project onboarding
- Create or import
packages/app/src/app/components/Create - Project dashboard
packages/app/src/app/pages/Dashboard - Workspace setup
packages/app/src/app/components/WorkspaceSetup
IDE experience
- Code editor UI
packages/app/src/app/components/CodeEditor - Preview and devtools
packages/app/src/app/components/Preview - Share project
packages/react-embed/src/SandboxEmbed/SandboxEmbed.tsx
Sandbox execution
- Module manager
packages/sandpack-core/src/manager.ts - Dependency fetch
packages/sandpack-core/src/npm/dynamic/fetch-npm-module.ts - Fetch protocols
packages/sandpack-core/src/npm/dynamic/fetch-protocols/index.ts - Module resolver
packages/sandpack-core/src/resolver/resolver.ts - Transpiled modules
packages/sandpack-core/src/transpiled-module/transpiled-module.ts - Browser file system
standalone-packages/codesandbox-browserfs/src/core/file_system.ts - LocalStorage backend
standalone-packages/codesandbox-browserfs/src/backend/LocalStorage.ts - WorkerFS backend
standalone-packages/codesandbox-browserfs/src/backend/WorkerFS.ts
Client platform
- Application state
packages/app/src/app/overmind - GraphQL client
packages/app/src/app/graphql/client.ts
Editor services
- TypeScript worker
standalone-packages/monaco-typescript/src/tsWorker.ts - Worker manager
standalone-packages/monaco-typescript/src/workerManager.ts - TextMate grammar
standalone-packages/vscode-textmate/src/main.ts
Other components
- Developer
- CodeSandbox API
Connections 23
- 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
packages/sandpack-core/src/manager.ts - Module manager → Transpiled modules: transpiles modules
packages/sandpack-core/src/manager.ts - Module manager → Dependency fetch: loads dependencies
packages/sandpack-core/src/manager.ts - Dependency fetch → Fetch protocols: selects protocol
packages/sandpack-core/src/npm/dynamic/fetch-npm-module.ts - Dependency fetch → Module resolver: resolves package
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
standalone-packages/monaco-typescript/src/workerManager.ts - TypeScript worker → Browser file system: configures filesystem
standalone-packages/monaco-typescript/src/tsWorker.ts - Browser file system → LocalStorage backend: backs filesystem
standalone-packages/codesandbox-browserfs/src/backend/LocalStorage.ts - Browser file system → WorkerFS backend: provides backend
standalone-packages/codesandbox-browserfs/src/backend/WorkerFS.ts - Code editor UI → Worker manager: requests language service
- Code editor UI → TextMate grammar: uses grammar highlighting