https://github.com/better-i18n/oss
Official TypeScript SDKs for Better i18n — Next.js, React, Expo/React Native integrations with CLI, MCP server, and CDN-powered translation delivery
https://github.com/better-i18n/oss
ai-agents cdn cli crowdin developer-tools expo i18n internationalization localization lokalise mcp next-intl nextjs react react-native translation typescript use-intl
Last synced: 23 days ago
JSON representation
Official TypeScript SDKs for Better i18n — Next.js, React, Expo/React Native integrations with CLI, MCP server, and CDN-powered translation delivery
- Host: GitHub
- URL: https://github.com/better-i18n/oss
- Owner: better-i18n
- License: mit
- Created: 2026-02-01T09:54:46.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-05-22T16:34:19.000Z (about 1 month ago)
- Last Synced: 2026-05-22T20:48:07.617Z (about 1 month ago)
- Topics: ai-agents, cdn, cli, crowdin, developer-tools, expo, i18n, internationalization, localization, lokalise, mcp, next-intl, nextjs, react, react-native, translation, typescript, use-intl
- Language: TypeScript
- Homepage: https://better-i18n.com/
- Size: 22.7 MB
- Stars: 12
- Watchers: 0
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
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](https://cloudflare.com), updated without redeployment
- **AI-powered** — context-aware translation with [Google Gemini](https://deepmind.google/technologies/gemini/), not word-by-word machine output
- **TypeScript-first** — full type safety across [Next.js](https://nextjs.org), [React](https://react.dev), [Expo](https://expo.dev), and [React Native](https://reactnative.dev)
- **MCP-ready** — AI agents can manage translations through the [Model Context Protocol](https://modelcontextprotocol.io/)
### How it compares
| Feature | Better i18n | [Crowdin](https://crowdin.com) | [Lokalise](https://lokalise.com) | [Phrase](https://phrase.com) |
|---------|:-----------:|:------:|:--------:|:------:|
| 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](https://nextjs.org) SDK with middleware and hooks | [](https://www.npmjs.com/package/@better-i18n/next) |
| [`@better-i18n/use-intl`](./packages/use-intl) | [React](https://react.dev) hooks for [use-intl](https://www.npmjs.com/package/use-intl) integration | [](https://www.npmjs.com/package/@better-i18n/use-intl) |
| [`@better-i18n/expo`](./packages/expo) | [Expo](https://expo.dev) / [React Native](https://reactnative.dev) 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](https://modelcontextprotocol.io/) server for AI agent integration | [](https://www.npmjs.com/package/@better-i18n/mcp) |
| [`@better-i18n/schemas`](./packages/schemas) | Shared [Zod](https://zod.dev) validation schemas | [](https://www.npmjs.com/package/@better-i18n/schemas) |
## Quick Start
```bash
# 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
```bash
npm install @better-i18n/next
```
```typescript
// middleware.ts
import { createI18nMiddleware } from '@better-i18n/next';
export default createI18nMiddleware({
locales: ['en', 'tr', 'de'],
defaultLocale: 'en',
});
```
See the [Next.js integration guide](https://docs.better-i18n.com/sdk/next) for routing, server components, and metadata setup.
### React with use-intl
```bash
npm install @better-i18n/use-intl
```
```tsx
import { BetterI18nProvider, useTranslations } from '@better-i18n/use-intl';
function App() {
return (
);
}
function MyComponent() {
const t = useTranslations('common');
return
{t('welcome')}
;
}
```
### Expo / React Native
```bash
npm install @better-i18n/expo
```
```tsx
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](https://docs.better-i18n.com/sdk/expo).
### MCP Server (AI Agents)
```bash
npm install @better-i18n/mcp
```
Connect AI assistants like [Claude](https://claude.ai), [Cursor](https://cursor.com), or [Windsurf](https://windsurf.com) to your translation workflow through the [Model Context Protocol](https://modelcontextprotocol.io/).
### 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.
```bash
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](https://github.com/better-i18n/skills).
## Documentation
Visit [docs.better-i18n.com](https://docs.better-i18n.com) for full documentation:
- [Getting Started](https://docs.better-i18n.com/getting-started) — setup and first project
- [CLI Reference](https://docs.better-i18n.com/cli) — all commands and options
- [SDK Guides](https://docs.better-i18n.com/sdk) — Next.js, React, Expo integrations
- [API Reference](https://docs.better-i18n.com/api) — REST API documentation
- [MCP Integration](https://docs.better-i18n.com/mcp) — AI agent setup
## Related
- [better-i18n/skills](https://github.com/better-i18n/skills) — AI agent skills for i18n best practices
- [better-i18n/status.better-i18n.com](https://github.com/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