Repository navigation
Error Codes i18n
github-actions[bot] edited this page Nov 16, 2026
·
1 revision
Part of Error codes: every code @ultimat3/i18n registers. x errors explain <CODE> --json prints the same row.
| Code | Means | Typical cause | Fix |
|---|---|---|---|
X_CATALOG_INVALID |
a catalog entry is malformed | bad interpolation or a non-string value | x i18n check --json |
X_CATALOG_MISSING_KEYS |
a catalog is missing keys used in source | a new t(), mail or push key with no translation, a key en defines that this locale lacks, or a key a mounted admin derives (admin.<table>.field.<column>; no source file spells one). The sync writes the file nested — a hand-added dotted key is X_CATALOG_INVALID — the default locale's admin keys with the label x g resource --admin writes, every other key as a ⟦…⟧ placeholder to replace |
x i18n sync <locale> |
X_CATALOG_UNREGISTERED |
a shipped catalog never reached the runtime registry |
defineCatalogs() in a module the boot scan never imports, or one that throws on import — every string renders ⟦key⟧ while x verify is green. When two copies of @ultimat3/i18n are installed the cause says so instead, and the fix is the install's (X_PACKAGE_DUPLICATED, reported beside it): the call is where it should be and registered into the copy the CLI does not read |
move the defineCatalogs() call into packages/i18n/src/index.ts and read strings through its useT(); x i18n check --json re-checks |
X_I18N_FAMILY_INCOMPLETE |
a select or ordinal family has no _other | a catalog defines select or ordinal keys and no _select_other or _ordinal_other, so a value the family does not name renders the loud miss |
x i18n check --json — then add _select_other (or _ordinal_other) to the catalog it names
|
X_LOCALE_UNSUPPORTED |
locale is not in the supported set | a URL or header requesting an unconfigured locale | x i18n add <locale> |
Ultimate — v31.43.0 As of 2026-10. The full-stack framework where the primary developer is an AI agent: bunx create-ultimate myapp → Getting started · live demo. MIT licensed. What npm serves is npm view @ultimat3/core version, never this line, and this footer is the only page that stamps a version.
Repository · Issues · Changelog · llms.txt
Edits to these pages are synced from wiki/ in the repository — change the file there, not the wiki, or the next sync overwrites it.
Start
- Getting started
- Installation
- Shapes
- Bare VM
- Project layout
- Migrating an existing app
- Compared to other stacks
Tutorials
- 1 · First app
- 2 · First feature
- 3 · Auth and admin
- 4 · Jobs and realtime
- 5 · Deploy free
- 6 · Growing up
Primitives
- The eight primitives
- Building your own base
- Actions
- Entities and migrations
- Policies and authz
- Queries and live queries
- Client data
- Jobs and workflows
- Scheduled tasks
- Routes and render modes
Capabilities
- Realtime
- Caching and invalidation
- Batching and preloading
- N+1 detection
- PWA and offline
- Client navigation
- MCP and AI
- Agents
- Admin dashboard
- Scraping
- Auth
- Notify
- Storage and uploads
- Feature flags
- SEO
- Static assets
Cross-cutting
- I18n
- Theming
- UI components
- Interface rules
- Timezones and dates
- Money
- Outbound HTTP
- Resource management
- Migrations and backfills
- Testing
- CI: the gate across parallel jobs
Reference