# codespace-web

Frontend IDE shell for the codespace Go backend.

## Scope

This package is a runnable **UI scaffold only**. It provides the workspace layout, a mock file explorer, a Monaco editor wrapper, and an xterm terminal wrapper. It does not yet connect to the Go API.

## Commands

| Command | Purpose |
|---|---|
| `pnpm install` | Install dependencies |
| `pnpm dev` | Start the Vite dev server |
| `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 (provider only; no real API calls yet)
- `@monaco-editor/react` editor wrapper
- `@xterm/xterm` + `@xterm/addon-fit` terminal wrapper
- `react-resizable-panels` for layout splits
- `lucide-react` for icons

## Non-goals

- Backend API integration (reserved file only at `src/lib/api/client.ts`)
- Authentication
- WebSocket terminal or process streaming
- i18n
- Tests (no test framework until business logic is added)