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

npm install
npm run dev

Environment

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.