flxn-app/CLAUDE.md

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).