Frontend guidance — `src/`
React 19 + TypeScript + Tailwind v4, talking to the Rust backend over Tauri `invoke()`.
Read [`../CLAUDE.md`](../CLAUDE.md) first for the project-wide rules.
---
## 1. Internationalisation — the rule that
1.2k28d agoReviewMountCreate a free account to mount
complete.
- Text a **player** will read is a **translation key**, never English prose. The frontend resolves
keys via `src/utils/backendI18n.ts`; `scripts/audit-i18n.mjs` scans `src-tauri/` for literals that
escaped. Adding
1.2k28d agoReviewMountCreate a free account to mount
KolibriAuthPermissions` from `kolibri.core.auth.permissions`.
- **Error constants**: API validation errors use codes from `kolibri/core/error_constants.py`, mirrored in frontend.
### Multi-Agent / Multi-Worktree Isolation
→ See `docs/howtos/multi_agent_setup.md` for full setup including KOLIBRI_HOME isolation
1.2k3mo agoReviewMountCreate a free account to mount
endpoints belong in `turbo/apps/api` (Hono,
`src/signals/routes/`). Browser clients call the canonical API service.
Frontend apps must not add API handlers or thin proxy handlers. If a frontend
origin must expose
1.2k8mo agoReviewMountCreate a free account to mount
split PRs:**
- **Multiple unrelated behaviors** (authentication vs database vs caching)
- **Different deployment boundaries** (frontend vs backend in systems with separate deployment pipelines)
- **Refactoring separate from new features** (clean up existing
1.2k2mo agoReviewMountCreate a free account to mount
owner. It uses Laravel 13 (PHP 8.5) backend with React 19 frontend via Inertia.js v3.
## Commands
### Development
```bash
composer run dev # Start full dev environment (PHP server, queue, Vite, logs
1.1k3mo agoReviewMountCreate a free account to mount
methodology for this project.** With 121 test files and 1580+ tests across unit, integration, frontend, and snapshot layers, the test infrastructure is mature. All non-trivial work MUST follow
1.1k9mo agoReviewMountCreate a free account to mount
come up most here: `vercel-react-best-practices` and `vercel-composition-patterns` (React/Next work), `frontend-design`, `make-interfaces-feel-better`, `emil-design-eng` and `web-design-guidelines` (UI), `changelog-maintenance
1.1k52d agoReviewMountCreate a free account to mount
exist, but you can still run the script if `echo $MORPH_API_KEY` works.
# Frontend
This project uses React, TanStack Router, TanStack Query, Shadcn UI, and Tailwind CSS.
Always
1.1k11mo agoReviewMountCreate a free account to mount
Flowxtra — own repo, no shared code without a written arrangement |
| Backend | Python (agent + FastAPI) |
| Frontend | Next.js |
| Database | PostgreSQL **and SQLite**, both from the first migration, behind SQLAlchemy (D-029) |
| Voice
1.1k2mo agoReviewMountCreate a free account to mount
A file Claude Code reads at the start of every session. It holds the commands, conventions and warnings the agent needs for this project.
Where does it go?
At the repository root. Claude Code also reads CLAUDE.md files in subdirectories when it works there.
What should it contain?
Build and test commands, the project's layout, conventions that aren't obvious from the code, and mistakes to avoid. Short files tend to work better than long ones.
CLAUDE.md or AGENTS.md?
Claude Code reads CLAUDE.md; most other agents read AGENTS.md. Many projects keep one and point the other at it.