Codeerstandaarden

ToolingCopy Anchor Link

• bun fmt formatteert en bun lint lint, met Biome voor de regels die bun lint mist (a11y en een paar andere). Draai bun run lint:check en bun run format.
• TypeScript strict mode. any is toegestaan maar geeft een waarschuwing. Ongebruikte variabelen/imports zijn fouten.
• Geen discussie over tabs vs spaces: bun fmt dwingt tabs en een regelbreedte van 120 tekens af (bunfig.toml).

ConventiesCopy Anchor Link

• Geef de voorkeur aan named exports boven default exports
• Plaats tests naast de broncode: foo.ts + foo.test.ts
• Hooks horen in hooks/, componenten in components/, routebestanden in routes/
• Code aan serverzijde importeert nooit uit client-only paden (en omgekeerd)

Wat hoort waarCopy Anchor Link

• Echt gedeelde logica → packages/core
• Web-only logica → apps/web/src
• API-only logica → apps/api/src
• Alles wat platformbewust is (auth storage, fetch) → packages/api-client/{web,mobile}

Niet doenCopy Anchor Link

• Voeg geen console.log toe aan gecommitte code; gebruik de logger uit @routess/core
• Introduceer geen nieuwe state-library; Zustand en React Query dekken het
• Voeg geen CSS-in-JS-library toe; we hebben Tailwind v4 + design tokens