# Repo Guidance

- Do not bypass `@pikku/mantine` i18n typing by wrapping final text in plain HTML elements such as `span` or `div`.
- Do not use wrapper-based "neutralization" to silence `I18nNode` errors.
- `Text` may contain plain numeric children like `{1}` when the value is a number, but do not brand digit literals like `'1'` as translation text.
- Fix the root issue instead:
  - use `t('...')` for real UI copy
  - improve shared component typings/helpers when needed
  - use `asI18n(...)` only in an explicit, deliberate pass
- If the correct fix is not clear, stop and ask before introducing a workaround.
