codespace/web

codespace-web

Frontend IDE shell for the codespace Go backend.

Scope

This package is the codespace web IDE. It connects to the Go backend: the file explorer and editor call the file APIs, the toolbar drives the process start/stop/restart endpoints, and the terminal streams the running OpenCode process over the WebSocket endpoint /api/workspaces/:id/process/ws.

Commands

Command	Purpose
pnpm install	Install dependencies
pnpm dev	Start the Vite dev server (proxies /api and /healthz to http://localhost:8080)
pnpm lint	Run ESLint
pnpm build	Type-check and build for production

Stack

• Vite + React 19 + TypeScript
• Tailwind CSS v4
• react-router v7
• Zustand for local UI state
• TanStack Query for API state
• @monaco-editor/react editor wrapper
• @xterm/xterm + @xterm/addon-fit terminal wrapper
• react-resizable-panels for layout splits
• lucide-react for icons

Non-goals

• Authentication
• i18n
• Tests (no test framework until business logic is added)