39 lines
1.0 KiB
Markdown
39 lines
1.0 KiB
Markdown
# 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)
|