Changelog

New #

• Versioned CDN delivery. Every publish now writes immutable /v/{version}/ files next to the legacy paths, and @better-i18n/core 0.14.2 reads them when the manifest carries a version. Deploys can no longer serve a half-updated translation file.
• Target languages detected from your repo. Connecting a GitHub repository with ja-JP.json and zh-TW.json now adds ja and zh-hant automatically and imports the existing translations, so the first publish is a real diff instead of an empty file.
• Organization activity and account deletion. Every organization now has an activity log, and you can delete your account from Settings; a 14-day grace period keeps the data recoverable.

Improved #

• GitHub connect always comes back. Installing or adding a GitHub account returns you to the project you started from, in a popup or in the same tab. Reconnect after a revoked token is one click, and the dashboard shows exactly which repository is linked.
• "Sync now" respects the initial import. Manual sync on a freshly connected repo runs the same import as setup, instead of a partial source sync.
• Install snippets show current versions. Setup screens read package versions from npm, so @better-i18n/sdk 3.5.0 is what you copy.
• Docs links inside the dashboard point to the new help center and developer docs.
• Onboarding follow-up. If a project sits in setup for a day, we send one email with the exact step that is missing.

Security #

• Dashboard responses carry X-Frame-Options: DENY and X-Content-Type-Options: nosniff.
• Repository connect and GitHub actions check the organization role through the same permission layer as the rest of the API.
• Soft-deleted keys are denormalized onto translations, so a deleted key can never reach the CDN through a stale join.

Fixed #

• Deleting an organization while a member was being added could leave orphaned rows; the delete is now transactional.
• Language-only publishes no longer regenerate translation files for GitHub projects.

New #

• better-i18n doctor — a full i18n health report (score 0–100) and better-i18n scan to find hardcoded strings not wrapped in t().
• Namespaced CDN delivery. Large projects can serve one file per namespace per locale, so each page fetches only the namespaces it needs.

Improved #

• Every CLI command now supports --json for machine-readable output in CI and agent workflows.

New #

• MCP servers. @better-i18n/mcp (11 translation tools) and @better-i18n/mcp-content (17 content tools) let ChatGPT, Claude, Cursor, and Gemini manage your i18n directly. Remote server at https://mcp.better-i18n.com/mcp.
• Agent Skill. npx skills add better-i18n/skills gives your AI agent permanent knowledge of SDK patterns, CDN behavior, and key conventions — no per-session prompting.

Improved #

• AI translation is now context-aware, using namespace descriptions and your glossary.

New #

• iOS (Swift) SDK — reactive translations in SwiftUI via I18nStore, with offline-first two-phase loading and WidgetKit support.
• Flutter SDK (better_i18n) — pure Dart, reactive BetterI18nProvider, 4-tier offline fallback, no codegen.
• Expo SDK (@better-i18n/expo) — i18next integration that works in Expo Go with MMKV/AsyncStorage offline caching.

All three share the same CDN infrastructure as the web SDKs — manage translations once, ship everywhere.

New #

• OAuth 2.0 Authorization Code support. Build platforms, IDE plugins, and agents that manage translations on behalf of your users — scoped, consent-driven, and revocable.
• Installation tokens (bi_oat_): short-lived (1h), per-organization, per-project scoped credentials that work across REST, MCP, and CDN.

Security #

• Two-layer token model: access tokens mint installation tokens but can't read resources; installation tokens read/write but can't escalate.

New #

• Content CMS. Manage structured, localized content — blog posts, FAQs, marketing pages — with content models, fields, and entries, delivered through the same edge CDN as your translations. Includes built-in view analytics.
• Admin SDK (@better-i18n/admin). A typed, server-side SDK for programmatic access to projects, keys, translations, content, analytics, and sync from your own backend, scripts, or CI.

Improved #

• Analytics now break down views by entry, language, country, and time series.