Skip to content
For Developers

Localization Built for Developers

Type-safe SDKs, CLI tools, and MCP integration. Ship translations without leaving your IDE.

Type-Safe SDKs

Full TypeScript support with autocomplete for translation keys

Git-First Workflow

Automatic key discovery from your codebase via AST parsing

MCP Integration

Manage translations directly from Claude or Cursor

CLI Tools

Scan codebase, sync translations, and validate keys from terminal

Edge CDN

Sub-50ms translation delivery from Cloudflare's global network

Hot Reload

See translation changes instantly during development

Get Started in Minutes

Simple setup, powerful features. No complex configuration required.

# Install the SDK
npm install @better-i18n/next

# Configure your project
npx better-i18n init

# Scan for translation keys
npx better-i18n scan

# Your code stays clean
import { useTranslations } from '@better-i18n/use-intl';

function Component() {
  const t = useT('common');
  return <h1>{t('welcome')}</h1>;
}

Edge CDN Performance

Translations are served from Cloudflare's global edge network with aggressive caching and smart invalidation so your users always get the fastest possible load times.

Manifest Cache5-minute TTL with smart invalidation on publish
Translation Cache1-hour TTL for optimal repeat-visit performance
Global Propagation5-10 second cache propagation after publish
Cache PurgingPublish triggers global invalidation instantly
Preload Support<link rel=preload> for faster initial loading
Edge LocationsNorth America, Europe, and Asia Pacific
Immutable Assets1-year cache for static assets like flags

REST API & Webhooks

Programmatic access to every platform function. Manage projects, keys, and languages from your own tooling or CI pipeline.

// REST API methods
listProjects()
getProject(id)
addLanguage(projectId, locale)
listKeys(projectId)
createKeys(projectId, keys[])
updateKeys(projectId, keys[])
deleteKeys(projectId, keyIds[])

Webhook Events

Receive push events when syncs complete, translations are published, or keys are modified.

Batch Operations

Create, update, or delete multiple keys in a single request. Each key is tracked by a unique UUID across syncs.

Sync Status Tracking

Monitor sync jobs through pending, in-progress, completed, and failed states. Soft-deleted keys are preserved with timestamps for auditing.

Developer Experience

Built for developers who care about type safety, debugging, and performance observability.

Namespace Scoping

Automatic namespace binding via lexical scope analysis

Rich Type System

Full TypeScript types exported from @better-i18n/core

i18n.config.ts

Single workspace configuration file for all settings

Debug Logging

Verbose output for troubleshooting integration issues

Perf Monitoring

Execution time and cache hit rate reporting

Custom Fetch

Bring your own HTTP client for translation loading

Error Handlers

Custom callbacks for missing translation keys

Locale Callbacks

Event hooks for locale switching and changes

Infrastructure

Production-grade infrastructure with built-in security, redundancy, and multi-datacenter support.

Cloudflare Workers

Edge computing with built-in DDoS protection and global distribution

Cloudflare R2 Storage

Object storage for translation files with zero egress fees

PlanetScale Database

Serverless MySQL with automatic backups and branching

Multi-Datacenter

Redundant deployment across regions for high availability

Start Building Today

Free tier with generous limits. No credit card required.