Skip to content

Frontend Documentation

This folder contains developer-facing documentation for the Next.js frontend of the mithras-crm monorepo.

All files here follow the conventions defined in docs/technical-documentation-standard.md.

Structure

  • architecture.md — Next.js 14 App Router structure, tech stack, auth flow
  • authentication.md — Auth0 integration, JWT tokens, CASL permissions
  • components.md — Component organization (layout, page, shared) and patterns
  • customer.md — Customer management UI
  • data-fetching.md — Server-side fetch, React Query, infinite scroll, server actions
  • routes.md — Dashboard route structure, listing/detail/add/edit patterns

How to use

  • When you change or add a frontend feature area, update or create the corresponding file in this folder.
  • Prefer small, focused docs with links to other files over large, monolithic documents.
  • Use Mermaid diagrams for navigation, state flows, and key user journeys where they improve clarity.