# Better i18n Package Versions

Use these exact versions when installing packages:

| Package | Latest Version | Install Command |
|---------|----------------|-----------------|
| @better-i18n/next | 0.5.8 | npm install @better-i18n/next@0.5.8 |
| @better-i18n/use-intl | 0.1.14 | npm install @better-i18n/use-intl@0.1.14 |
| @better-i18n/expo | 0.7.0 | npm install @better-i18n/expo@0.7.0 |
| @better-i18n/cli | 0.2.5 | npx @better-i18n/cli@0.2.5 |
| @better-i18n/mcp | 0.15.4 | npx @better-i18n/mcp@0.15.4 |
| @better-i18n/mcp-content | 0.8.0 | npx @better-i18n/mcp-content@0.8.0 |
| @better-i18n/sdk | 3.2.0 | npm install @better-i18n/sdk@3.2.0 |
| @better-i18n/core | 0.2.2 | npm install @better-i18n/core@0.2.2 |

---

# Better i18n

> AI-powered localization platform for engineering teams — CDN-first delivery with optional GitHub workflows.

## Docs
- [llms.txt](/llms.txt): Table of contents with links to individual pages
- [llms-full.txt](/llms-full.txt): Complete documentation in a single file

## Table of Contents

## Core

### Platform
- [How It Works](/core/how-it-works.mdx): How Better i18n serves translations from the edge

### Package
- [Getting Started](/core.mdx): Framework-agnostic core utilities for Better i18n — fetch messages, languages, and manage locale detection from any JavaScript runtime
- [API Reference](/core/api-reference.mdx): Complete API documentation for @better-i18n/core
- [Locale URL Utilities](/core/locale-utilities.mdx): URL path manipulation utilities for locale-aware routing

## Frameworks

### Introduction
- [Quick Start](/frameworks/quick-start.mdx): Get Better i18n running in your React app in under 5 minutes
- [Provider](/frameworks/provider.mdx): Configure the BetterI18nProvider for your application
- [Translations](/frameworks/translations.mdx): Access translations with useTranslations, interpolation, and namespaces
- [Locale Management](/frameworks/locale.mdx): useLocale, useLocaleRouter, useLanguages, and LanguageSwitcher
- [Formatting](/frameworks/formatting.mdx): Format dates, numbers, lists, and relative times with useFormatter
- [Server Utilities](/frameworks/server.mdx): Server-side utilities for pre-loading translations and server-side translation

### Frameworks
- [Getting Started](/frameworks/nextjs.mdx): Set up @better-i18n/next in 5 minutes
- [Configuration](/frameworks/nextjs/configuration.mdx): All configuration options for @better-i18n/next
- [Middleware](/frameworks/nextjs/middleware.mdx): Next.js middleware configuration with Clerk-style callback pattern
- [Client-Side Features](/frameworks/nextjs/client.mdx): Client-side components and hooks for instant locale switching in Next.js
- [API Reference](/frameworks/nextjs/api-reference.mdx): Detailed API documentation for @better-i18n/next
- [Getting Started](/frameworks/tanstack-start.mdx): Complete i18n setup for TanStack Start with SSR support
- [Setup](/frameworks/tanstack-start/setup.mdx): Basic TanStack Start setup with Better i18n
- [SSR & Hydration](/frameworks/tanstack-start/ssr.mdx): Server-side rendering with Better i18n and TanStack Start
- [Path-Based Routing](/frameworks/tanstack-start/routing.mdx): SEO-friendly locale URLs with TanStack Router
- [Middleware](/frameworks/tanstack-start/middleware.mdx): Automatic locale detection with TanStack Start middleware
- [TypeScript](/frameworks/tanstack-start/typescript.mdx): Type-safe translation keys and autocomplete for TanStack Start
- [Getting Started](/frameworks/vite.mdx): Client-side i18n setup for Vite and React applications
- [Setup](/frameworks/vite/setup.mdx): Installation and provider setup for Vite + React applications
- [React Router](/frameworks/vite/react-router.mdx): Integrate Better i18n with React Router
- [TypeScript](/frameworks/vite/typescript.mdx): Type-safe translation keys and autocomplete for Vite + React
- [Getting Started](/frameworks/remix.mdx): CDN-powered i18n for Remix & Shopify Hydrogen
- [Setup](/frameworks/remix/setup.mdx): Step-by-step installation and configuration for @better-i18n/remix
- [Locale Detection](/frameworks/remix/locale-detection.mdx): Detect user locale from URLs, headers, and custom strategies
- [Routing](/frameworks/remix/routing.mdx): Locale-prefixed URLs, LocaleLink, and LocaleSwitcher for Remix apps
- [Shopify Hydrogen](/frameworks/remix/hydrogen.mdx): Integrate Better i18n with Shopify Hydrogen for multilingual storefronts
- [API Reference](/frameworks/remix/api-reference.mdx): Complete API documentation for @better-i18n/remix
- [Getting Started](/frameworks/expo.mdx): i18next integration for Expo and React Native with offline caching and instant language switching
- [Setup](/frameworks/expo/setup.mdx): Installation and configuration for Expo and React Native
- [Offline & Caching](/frameworks/expo/offline-caching.mdx): How persistent caching and offline fallback works in @better-i18n/expo
- [Dynamic CFBundleLocalizations](/frameworks/expo/dynamic-localizations.mdx): Automatically sync iOS locale support with your Better i18n CDN languages

### Native
- [Widget Extension](/frameworks/expo/widget-extension.mdx): Use BetterI18n Swift SDK to bring translations into WidgetKit extensions from your Expo app.
- [API Reference](/frameworks/expo/api-reference.mdx): Complete API documentation for @better-i18n/expo
- [Getting Started](/frameworks/ios.mdx): Native iOS i18n with the BetterI18n Swift SDK — reactive translations in SwiftUI.
- [Setup](/frameworks/ios/setup.mdx): Install and configure BetterI18n in a SwiftUI app using Swift Package Manager.
- [API Reference](/frameworks/ios/api-reference.mdx): Complete API reference for the BetterI18n Swift SDK — I18nConfig, I18nStore, BetterI18n, and Translator.
- [Getting Started](/frameworks/flutter.mdx): Native Flutter i18n with the better_i18n Dart SDK — CDN-driven translations with offline support.
- [Setup](/frameworks/flutter/setup.mdx): Install better_i18n and configure BetterI18nProvider in your Flutter app.
- [Offline & Caching](/frameworks/flutter/offline-caching.mdx): Four-tier fallback chain, SharedPrefsStorage, and staticData for always-available translations.
- [API Reference](/frameworks/flutter/api-reference.mdx): Complete API documentation for the better_i18n Flutter SDK.
- [Getting Started](/frameworks/server-sdk.mdx): Runtime-agnostic server-side i18n for any JavaScript backend
- [Hono](/frameworks/server-sdk/hono.mdx): Better i18n middleware for Hono
- [Express & Fastify](/frameworks/server-sdk/node.mdx): Node.js HTTP adapter for Express, Fastify, and Koa
- [Supabase Edge Functions](/frameworks/server-sdk/supabase.mdx): Runtime-agnostic i18n in Supabase Edge Functions (Deno)
- [tRPC](/frameworks/server-sdk/trpc.mdx): Localized error messages and i18n context in tRPC procedures
- [API Reference](/frameworks/server-sdk/api-reference.mdx): Full API reference for @better-i18n/server

## Content SDK
- [Introduction](/sdk.mdx): Headless CMS client for Better i18n content

### Setup
- [Getting Started](/sdk/getting-started.mdx): Install and configure the Content SDK

### Usage
- [Models & Entries](/sdk/models-and-entries.mdx): Query content with the chainable from() API
- [API Reference](/sdk/api-reference.mdx): Complete SDK method and type reference

### Advanced
- [TypeScript](/sdk/typescript.mdx): Type-safe content with generic custom fields

## MCP Server
- [Introduction](/mcp.mdx): AI assistant integration for translation management

### Setup
- [Coding Agents](/mcp/getting-started.mdx): Configure MCP server for Cursor, Claude Code, Windsurf, Zed, Codex, and more
- [AI Assistants](/mcp/ai-assistants.mdx): Connect ChatGPT, Claude, and Gemini to your translation workspace

### Tools
- [Available Tools](/mcp/tool-reference.mdx): MCP tools for translation and content management

## CLI
- [Introduction](/cli.mdx): Detect and sync translation keys in your React/Next.js apps

### Commands
- [scan](/cli/scan.mdx): Find hardcoded strings in your codebase
- [check](/cli/check.mdx): Interactive checker for missing and unused translation keys
- [sync](/cli/sync.mdx): Compare local translation keys with Better i18n cloud
- [doctor](/cli/doctor.mdx): Analyze your project's i18n health — missing translations, hardcoded strings, orphan keys, and CDN sync in one command.

### Setup
- [Configuration](/cli/configuration.mdx): Configure CLI behavior and project context with i18n.config.ts

## API
- [API Reference](/api.mdx): Complete API reference for Better i18n MCP tools and REST endpoints.
- [listProjects](/api/list-projects.mdx): List all projects you have access to across all organizations.
- [getProject](/api/get-project.mdx): Get project details including namespaces, languages, and translation coverage.
- [addLanguage](/api/add-language.mdx): Add a new target language to a project.
- [listKeys](/api/list-keys.mdx): Get translation keys with search, filters, and translations.
- [createKeys](/api/create-keys.mdx): Create new translation keys with source text and translations.
- [updateKeys](/api/update-keys.mdx): Update translations for existing keys.
- [deleteKeys](/api/delete-keys.mdx): Soft-delete translation keys by UUID.
- [getSyncs](/api/get-syncs.mdx): List recent sync operations for a project.
- [getSync](/api/get-sync.mdx): Get details about a specific sync operation.
- [Security](/security.mdx): Security practices and policies for Better i18n.