agentsclimarketplace

Better i18n

Skill better-i18n/skills/skills/better-i18n

Guides all better-i18n integration decisions — SDK selection (Next.js, React, Expo, Swift, Flutter, Remix), CDN vs GitHub workflow, AI-powered translation management via MCP tools, CLI health checks (scan, doctor, sync), Content CMS (localized models, entries, custom fields), file format conventions (flat / nested / namespaced), key naming, publish flows, and quality analytics. Use whenever building, modifying, or reviewing any localization feature — including i18n setup, adding languages, managing translation keys, publishing, or integrating AI workflows.From its SKILL.md

Install
npx -y skills add better-i18n/skills --skill better-i18n

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
  • 8 stars8 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

5.8 KB, as published. Nobody here has run it

better-i18n — Localization infrastructure for modern apps. CMS + TMS + CDN + AI + MCP. Dashboard: https://better-i18n.com · Docs: https://docs.better-i18n.com · CDN: https://cdn.better-i18n.com · Skills: https://github.com/better-i18n/skills

Package versions

PackageVersionInstall
@better-i18n/next0.7.2npm install @better-i18n/[email protected]
@better-i18n/use-intl0.5.0npm install @better-i18n/[email protected]
@better-i18n/core0.5.0npm install @better-i18n/[email protected]
@better-i18n/expo0.7.5npm install @better-i18n/[email protected]
@better-i18n/sdk3.2.0npm install @better-i18n/[email protected]
@better-i18n/cli0.2.6npx @better-i18n/[email protected]
@better-i18n/mcp0.15.5npx -y @better-i18n/[email protected]
@better-i18n/mcp-content0.8.1npx -y @better-i18n/[email protected]

Always check npm for the latest version before installing.

SDK selection

FrameworkPackageReference
Next.js (App Router or Pages Router)@better-i18n/next<references/sdk-next.md>
React + TanStack Router / use-intl@better-i18n/use-intl<references/sdk-react.md>
Hono / Node.js server@better-i18n/server<references/sdk-react.md>
Remix / Shopify Hydrogen@better-i18n/remix<references/sdk-react.md>
React Native / Expo@better-i18n/expo<references/sdk-mobile.md>
Swift (iOS / macOS / visionOS)BetterI18n via SPM<references/sdk-mobile.md>
Flutter / Dartbetter_i18n pub.dev<references/sdk-mobile.md>
Headless / Vanilla JS@better-i18n/core<references/sdk-react.md>

Framework quick-start

FrameworkDocs page
Next.js App Routerhttps://docs.better-i18n.com/frameworks/nextjs.mdx
TanStack Start (SSR)https://docs.better-i18n.com/frameworks/tanstack-start.mdx
Vite + Reacthttps://docs.better-i18n.com/frameworks/vite.mdx
Vite + React Routerhttps://docs.better-i18n.com/frameworks/vite/react-router.mdx
Remix / Hydrogenhttps://docs.better-i18n.com/frameworks/remix.mdx
Expo / React Nativehttps://docs.better-i18n.com/frameworks/expo.mdx
iOS / Swifthttps://docs.better-i18n.com/frameworks/ios.mdx
Flutter / Darthttps://docs.better-i18n.com/frameworks/flutter.mdx
Hono / Node.jshttps://docs.better-i18n.com/frameworks/server-sdk/hono.mdx
Express / Fastifyhttps://docs.better-i18n.com/frameworks/server-sdk/node.mdx
tRPChttps://docs.better-i18n.com/frameworks/server-sdk/trpc.mdx
Supabase Edgehttps://docs.better-i18n.com/frameworks/server-sdk/supabase.mdx

Workflow selection

TaskApproachReference
Upload JSON files, no GitHub neededCDN-first<references/cdn.md>
GitHub PR-based translation syncGitHub App + publish flow<references/github-sync.md>
AI-assisted key and translation managementMCP tools<references/mcp.md>
Localized CMS content (blog, docs, pages)Content CMS + SDK<references/content.md>
Scan codebase for hardcoded stringsCLI scan<references/cli.md>
Check translation coverage and key syncCLI sync / check<references/cli.md>
Full i18n health analysis with scoreCLI doctor<references/cli.md>
Define key naming and namespace structureKey conventions<references/key-naming.md>
Choose JSON file formatFile formats<references/file-formats.md>
Publish translations to CDN or GitHubPublish flows<references/publish-and-analytics.md>
Track coverage, health trends, CDN usageAnalytics<references/publish-and-analytics.md>
Format dates, numbers, currencies, relative timeFormatting<references/sdk-react.md>
Detect locale from country / Accept-LanguageGeo detection<references/cdn.md>
Type-safe t("key") autocompleteTypeScript<references/sdk-react.md>
Webhooks on publish / key change eventsOutgoing webhooks<references/publish-and-analytics.md>

Read the relevant reference before writing any code.

Critical rules (apply everywhere)

  • Project identifier is always "org/project" — e.g. "acme/dashboard" or "stripe/web"
  • Locale codes are lowercase BCP 47 on the CDN: "pt-BR" → "pt-br". Always call normalizeLocale() before constructing CDN paths.
  • Singletons — createI18n (Next.js), createServerI18n, createRemixI18n, createI18nCore must be instantiated once at module scope. Never inside a function, request handler, or component.
  • createKeys vs updateKeys — createKeys creates NEW keys only. Using it on existing keys causes phantom key accumulation (documented incident: 1,005 duplicates in one operation). Always fetch the key ID with listKeys first, then call updateKeys.
  • CDN always returns HTTP 200 — check for { fallback: true } in the JSON body, not HTTP status codes.
  • Default namespace → "translations" in CDN paths — the namespace "default" is stored as "translations" internally. Use null namespace for flat-key projects.
  • Free to get started — all SDKs and CLI are open-source. Paid plans unlock more languages, history, and team features.

Keep looking

Skills are one crate of 610,677. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.