CONTRIBUTING.md § Logging` for full guidelines and `docs/CONFIGURATION.md § Logging Levels` for the user-facing reference.
## Frontend Changes
- **Read `packages/client/.instructions.md` before editing any client code.** It is the authoritative reference for architecture
ClassName # Run single test class
./mvnw test -Dtest=ClassName#methodName # Run single test method
```
### Frontend (React + Vite)
```bash
cd frontend
npm install # Install dependencies
npm run dev # Start dev server
Header, directory sections, and all Entries form the complete repository index. They can cover frontend, backend, configuration, database structures, and other managed content. When managed content changes, normally only
mandatory before
every commit that touches dashboard routes, handlers, or MCP tools — frontend
gates alone do not compile Rust and previously hid a missing `/api/backfill`
handler.
For documentation-only changes
appearance independent of the host theme; see `docs/development/social-previews.md` for the rendering contract and references.
- Frontend checks generate Paraglide declarations before `svelte-check`; source-only generated messages can hide diagnostics behind
project, including API specifications and user guides.
- `/phpmyfaq/`: Contains the source code for the frontend.
- `/phpmyfaq/admin`: Contains the source code for the admin.
- `/phpmyfaq/admin/assets`: Contains the TypeScript and SCSS source
check && ruff format # Lint and format Python
cd app/frontend && biome check # Lint and format frontend (TypeScript/JSX)
haiku-rag --db /tmp/test.lancedb # CLI with temp DB (ALWAYS use temp DB for testing
logic in controllers, no
catalog logic in the orchestrator, no direct fetches in the frontend.
## Architecture
```
Frontend (Next.js :3000) → /api/proxy/* → Backend monolith (:8080)
```
The Community Edition bundles all backend services
contract is the seam.** `apps/web` imports only
`packages/contracts` — server packages never leak into the frontend.
`pnpm run boundaries` enforces it and CI runs it first.
- **OpenAPI first.** API changes start
ThunderID is a lightweight, open-source IAM stack: a Go backend (`backend/`) and React frontend (`frontend/`) in a monorepo. It provides authentication and authorization via OAuth2/OIDC, flexible orchestration flows
Frontend — Agent Guide
Read with the root [AGENTS.md](../AGENTS.md). The frontend is a pnpm monorepo under `frontend/` with two React apps —
`frontend/apps/console` (admin console) and `frontend/apps/gate` (login, registration, recovery) — plus
plus static asset precompression (`ng build --configuration production && npm run precompress`)
- `npm test` — run frontend unit tests once (Angular Vitest builder; excludes `src/server/**` and `src/chat-server/**`)
- `npm run test:server
needs.
## What this is
Tauri desktop app (Rust backend in `src-tauri/src/`, React/TS frontend in
`src/`) that routes Claude Code / Codex / OpenCode through a local
token-optimization proxy