38 lines
1.1 KiB
Markdown
38 lines
1.1 KiB
Markdown
# Repository Guidelines
|
|
|
|
## Project Structure
|
|
|
|
This is a Vite React single-page WebGIS Agent workbench. Runtime TypeScript lives
|
|
under `src/`.
|
|
|
|
- `src/app/`: application shell and providers.
|
|
- `src/features/agent/`: controlled Agent UI protocol, schemas, renderer, and views.
|
|
- `src/features/map/`: WebGIS map shell and future MapLibre/deck.gl integrations.
|
|
- `src/shared/`: reusable UI, config, styles, and utilities.
|
|
- `src/mocks/`: MSW handlers and fixtures for backend-independent development.
|
|
- `src/test/`: Vitest setup.
|
|
- `server/`: same-origin Edge TTS adapter used by Vite and the production container.
|
|
|
|
## Commands
|
|
|
|
Use `pnpm`.
|
|
|
|
```bash
|
|
pnpm dev
|
|
pnpm build
|
|
pnpm typecheck
|
|
pnpm lint
|
|
pnpm test
|
|
pnpm test:browser
|
|
```
|
|
|
|
## Coding Notes
|
|
|
|
Use TypeScript and React function components. Prefer explicit exported types at
|
|
module boundaries. Keep Agent dynamic UI rendering schema-driven: Agent output
|
|
must be validated before it reaches React components.
|
|
|
|
Do not add Next.js APIs or general BFF routes to this frontend. Agent behavior
|
|
belongs in the Agent service; the local `server/` exception is limited to the
|
|
same-origin Edge TTS network adapter.
|