index.md

Languages Learner documentation

The single source of truth for the project. CLAUDE.md, AGENTS.md, and the Cursor rules (.cursor/rules/) are thin pointers into these pages — edit content here.

How to keep the docs current: maintaining-docs.md.

Architecture

• Overview — monorepo, Nx, config layers.
• Package interaction — dependency graph, FSD layers.
• Web SSR — the custom SSR of apps/web, the res.locals contract.
• Backend — NestJS, Supabase, RLS.
• Data layer — TanStack Query and Gravity DataSource.
• i18n — FormatJS, hash IDs, the locale pipeline.
• API contract — DTO → SDK generation.

Packages and apps

There is one page per workspace package in packages/, all fully documented. New packages start from the template.

Apps: web · backend · storybook · web-e2e

Packages: api · uikit · data-source · form-components · class-names · error-utils · react-utils · react-router-utils · i18n-core · locale · tailwind · zod · har-sanitizer · playwright-utils · component-core-tests-utils · app-core-tests-utils · app-integration-tests-utils

Process and conventions

• Conventions — commands, formatting, code rules, PRs.
• Roadmap — Now / Next / Later / Done.
• Maintaining docs — how agents keep the docs current.

Reference

• ADR log — architecture decision records (0001 — tsgo migration).