better-i18n/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

Packages

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 (
    <BetterI18nExpoProvider
      projectId="your-project-id"
      defaultLocale="en"
      fallbackMessages={fallback}
    >
      
    
  );
}

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 before submitting PRs.

License

MIT — Better i18n