# 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)