i18n

CLAUDE.md

@@ -0,0 +1,23 @@
+# FLXN
+
+## i18n (Lingui v6) — applies to every user-facing string
+
+Any change that adds, edits, or removes user-visible text must follow the
+`i18n` skill (`.claude/skills/i18n/SKILL.md`): wrap with context-bound Lingui
+macros, then `bun run extract`, translate new entries in every non-`en`
+locale, and `bun run i18n:check`. Adding a language: use the `add-language`
+skill.
+
+Hard rules (full detail in the skill):
+
+- Only `Trans`/`Plural`/`useLingui` from `@lingui/react/macro` and `msg` from
+  `@lingui/core/macro`. Never global `t`/`plural`/`select` from core/macro
+  (SSR locale bleed).
+- `useLingui()` at top level of components/hooks only; add `t`/`i18n` to memo
+  dep arrays.
+- Never hand-edit msgids or `src/locales/en/messages.po` (generated).
+- vite.config.ts babel plugin order (lingui before react-compiler) is
+  load-bearing.
+- `LinguiProvider` stays ABOVE `AuthProvider` in providers.tsx (localized
+  query hooks call useLingui), and `__root`'s `head()` must never read
+  `match`/context (circular route-type inference breaks beforeLoad typing).