How tastyeffectco/sandboxd works
sandboxd is a self-hosted AI app-building engine with an optional browser console and a headless /v1 API. A user creates an app from a prompt, starter, curated catalog entry, or public Git repository; the control plane provisions an isolated Docker sandbox, where an in-sandbox supervisor runs the app and coding agent. The app is exposed at a preview URL, and the console supports continued editing and Git push. README statements establish the main workflow and integrations; unsampled implementation details are represented only at documented subsystem level.
Main entry points: App.tsx Console shell · api.ts API client · main.go Sandbox lifecycle · AppView.tsx App workspace
Components 25
Web console
- Console shell
console/src/App.tsx - App workspace
console/src/AppView.tsx - App catalog
console/src/StoreView.tsx - Catalog data
console/src/catalog.ts - Starter templates
console/src/design/starters.ts - App overview
console/src/BrainGraph.tsx - App structure
console/src/brain.ts - Settings
console/src/SettingsView.tsx - Deploy controls
console/src/DeployModal.tsx - Release status
console/src/VersionPill.tsx - API client
console/src/api.ts
Control plane
- HTTP API
control-plane/internal/api/handlers.go - Agent tasks
control-plane/internal/api/v1_tasks.go - Preview access
control-plane/internal/api/preview_auth.go - Sandbox lifecycle
control-plane/cmd/sandboxd/main.go - Sleep and wake
control-plane/internal/wake/handler.go
Sandbox runtime
- Coding agent
control-plane/cmd/runtimed/task.go - App supervisor
control-plane/cmd/runtimed/main.go
State and routing
- Docker containers
control-plane/internal/docker/docker.go - SQLite state
control-plane/internal/store/store.go - Preview routing
control-plane/internal/traefik/traefik.go
Other components
- User
- Running app
- Git repository
- API consumer
Connections 31
- User → Console shell: uses
README.md - Console shell → App workspace: opens
console/src/App.tsx - Console shell → App catalog: opens
console/src/App.tsx - Console shell → Settings: opens
console/src/App.tsx - Console shell → App overview: opens
console/src/App.tsx - App catalog → Catalog data: lists
console/src/StoreView.tsx - App workspace → API client: requests
console/src/AppView.tsx - App catalog → API client: installs via
console/src/StoreView.tsx - Settings → API client: configures via
console/src/SettingsView.tsx - Console shell → API client: requests
console/src/App.tsx - API client → HTTP API: calls `/v1`
console/src/api.ts - API consumer → HTTP API: calls `/v1`
README.md - HTTP API → Sandbox lifecycle: provisions
control-plane/internal/api/handlers.go - Sandbox lifecycle → Docker containers: runs containers
- Sandbox lifecycle → SQLite state: persists state
- Sandbox lifecycle → Preview routing: configures URLs
README.md - Sandbox lifecycle → App supervisor: starts in sandbox
README.md - Agent tasks → Coding agent: submits tasks
control-plane/internal/api/v1_tasks.go - Coding agent → App workspace: builds app
README.md - App supervisor → Running app: serves app
README.md - Preview routing → Running app: routes URL
README.md - User → Running app: views
README.md - Git repository → API client: imports repo
README.md - App workspace → Git repository: pushes changes
README.md - Sleep and wake → Docker containers: starts sandbox
control-plane/internal/wake/handler.go - Sleep and wake → SQLite state: loads sandbox
control-plane/internal/wake/handler.go - Preview access → Running app: authorizes access
control-plane/internal/api/preview_auth.go - Console shell → Deploy controls: opens
- Console shell → Release status: shows upgrade
console/src/App.tsx - App overview → App structure: renders
console/src/BrainGraph.tsx - App workspace → Starter templates: selects starter
README.md