Oss

TypeScript SDKs for the Better i18n localization platform

Manage translations with CDN delivery, GitHub sync, and AI-powered workflows.

Documentation · Website · Blog

---

Why Better i18n?

Most localization tools weren't built for modern developer workflows. Better i18n is different:

• GitHub-native — translations sync as PRs, reviews happen in your existing workflow
• CDN-delivered — translations served from Cloudflare's edge network, updated without redeployment
• AI-powered — context-aware translation with Google Gemini, not word-by-word machine output
• TypeScript-first — full type safety across Next.js, React, Expo, and React Native
• MCP-ready — AI agents can manage translations through the Model Context Protocol

How it compares

| Feature | Better i18n | Crowdin | Lokalise | Phrase | |---------|:-----------:|:------:|:--------:|:------:| | GitHub-first workflow | ✅ | Partial | Partial | ❌ | | AI translation with context | ✅ | ✅ | ✅ | ✅ | | CDN delivery (no redeploy) | ✅ | ❌ | ❌ | ❌ | | TypeScript SDKs | ✅ | ❌ | ❌ | ❌ | | MCP server for AI agents | ✅ | ❌ | ❌ | ❌ | | CLI scanner (unused key detection) | ✅ | ❌ | ❌ | ❌ | | ICU MessageFormat support | ✅ | ✅ | ✅ | ✅ | | Open-source SDKs | ✅ | Partial | ❌ | ❌ | | Free tier | ✅ | ✅ | ❌ | ❌ |

Packages

| Package | Description | Version | |---------|-------------|---------| | [@better-i18n/cli](./packages/cli) | CLI for scanning, syncing, and managing translations | [](https://www.npmjs.com/package/@better-i18n/cli) | | [@better-i18n/next](./packages/next) | Next.js SDK with middleware and hooks | [](https://www.npmjs.com/package/@better-i18n/next) | | [@better-i18n/use-intl](./packages/use-intl) | React hooks for use-intl integration | [](https://www.npmjs.com/package/@better-i18n/use-intl) | | [@better-i18n/expo](./packages/expo) | Expo / React Native integration with offline caching | [](https://www.npmjs.com/package/@better-i18n/expo) | | [@better-i18n/core](./packages/core) | Core utilities for locale handling and formatting | [](https://www.npmjs.com/package/@better-i18n/core) | | [@better-i18n/mcp](./packages/mcp) | MCP server for AI agent integration | [](https://www.npmjs.com/package/@better-i18n/mcp) | | [@better-i18n/schemas](./packages/schemas) | Shared Zod validation schemas | [](https://www.npmjs.com/package/@better-i18n/schemas) |

Quick Start

# Install the CLI
npm install -g @better-i18n/cli

# Initialize in your project
npx @better-i18n/cli init

# Scan your codebase for translation keys
npx @better-i18n/cli scan

# Sync translations with the Better i18n platform
npx @better-i18n/cli sync

Framework Integration

Next.js

npm install @better-i18n/next

// middleware.ts
import { createI18nMiddleware } from '@better-i18n/next';

export default createI18nMiddleware({
  locales: ['en', 'tr', 'de'],
  defaultLocale: 'en',
});

See the Next.js integration guide for routing, server components, and metadata setup.

React with use-intl

npm install @better-i18n/use-intl

import { BetterI18nProvider, useTranslations } from '@better-i18n/use-intl';

function App() {
  return (
    
      
    
  );
}

function MyComponent() {
  const t = useTranslations('common');
  return {t('welcome')};
}

Expo / React Native

npm install @better-i18n/expo

import { BetterI18nExpoProvider, useTranslations } from '@better-i18n/expo';

export default function App() {
  return (
    
      
    
  );
}

Supports offline caching, OTA translation updates, and automatic locale detection. See the Expo guide.

MCP Server (AI Agents)

npm install @better-i18n/mcp

Connect AI assistants like Claude, Cursor, or Windsurf to your translation workflow through the Model Context Protocol.

Agent Skill

Give your AI agent permanent better-i18n knowledge — SDK setup, key naming, CDN behavior, GitHub sync, and MCP tool usage — without pasting prompts each session.

npx skills add better-i18n/skills

Works with Claude Code, Cursor, Windsurf, and any agent that supports custom instructions. See github.com/better-i18n/skills.

Documentation

Visit docs.better-i18n.com for full documentation:

• Getting Started — setup and first project
• CLI Reference — all commands and options
• SDK Guides — Next.js, React, Expo integrations
• API Reference — REST API documentation
• MCP Integration — AI agent setup

Related

• better-i18n/skills — AI agent skills for i18n best practices
• better-i18n/status.better-i18n.com — open-source status page

Contributing

Contributions are welcome! Please read our [contributing guidelines](./CONTRIBUTING.md) before submitting PRs.

License

[MIT](./LICENSE) — Better i18n

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: better-i18n
• Source: better-i18n/oss
• License: MIT
• Homepage: https://better-i18n.com/

Install and usage instructions live in the source repository linked above.