# nomadcode-web

`nomadcode-web` is the initial React web frontend scaffold for NomadCode Server. It gives Agent Chat, Project Manage, and Settings pages a small but expandable layout.

## Stack

- React
- TypeScript
- Vite
- TanStack Router
- TanStack Query
- Zustand
- Plain CSS

## Run

```bash
npm install
npm run dev
```

## Environment

```bash
VITE_NOMADCODE_API_BASE_URL=http://localhost:8080
```

The default matches the current `nomadcode-core` local server.

## Pages

- `/agent`
- `/projects`
- `/settings`

## Mock and Stub Areas

- Agent messages are local mock state.
- Project actions log or open placeholder links.
- Settings integrations show mock configured/status values.
- Plane, Mattermost, IOP, and Agent Integrator calls are not implemented.
- WebSocket and proto-socket runtime flows are not implemented.

## Next Steps

- Connect task creation/listing to `nomadcode-core` `/api/tasks`.
- Add server-backed settings persistence.
- Add real project metadata loading.
- Add authenticated API access when Core auth is finalized.