i18n-best-practices
Use when building internationalization features, managing translation keys, setting up localization workflows, integrating AI translation, connecting GitHub repositories, delivering translations via CDN, using MCP tools for translation management, or implementing i18n SDKs in React/Next.js applic...
Full skill instructions
Guidance for building scalable, maintainable internationalization systems with Better i18n.
Better i18n is a GitHub-first localization platform with CDN-powered delivery:
[Your Repository] → [Better i18n Platform] → [Global CDN] → [Your App]
↓ ↓ ↓ ↓
AST Parsing AI Translation Edge Cached React/Next.js
Key Discovery Human Approval 5min manifest Vite/TanStack
GitHub Sync MCP Tools 1hr messages Any Framework
https://cdn.better-i18n.com/{org}/{project}/{resource}
Resources:
├── manifest.json # Available languages + metadata
├── {locale}.json # All translations for locale
├── {locale}/{namespace}.json # Namespaced translations
└── flags/{code}.svg # Country flag images
| Need to... | See |
|---|---|
| Set up a new i18n project | Getting Started |
| Use CLI commands (scan, check, sync) | CLI Usage |
| Organize translation keys and namespaces | Key Management |
| Translate content with AI assistance | AI Translation |
| Sync translations with GitHub repository | GitHub Sync |
| Serve translations via CDN | CDN Delivery |
| Use MCP tools in your IDE/agent | MCP Integration |
| Integrate with React or Next.js | SDK Integration |
| Handle plurals, dates, formatting | Best Practices |
New project?
Start with Getting Started to create your project and configure i18n.config.ts. Then use CLI Usage to scan your codebase for hardcoded strings.
Existing codebase with hardcoded strings?
Run better-i18n scan to detect strings needing translation. The CLI uses AST parsing to automatically differentiate UI text from developer symbols. See CLI Usage.
Need translations fast? Use AI Translation to translate content with context-aware AI. Set up a glossary first to ensure consistent terminology across all translations.
Building with Next.js?
Use @better-i18n/next which integrates with next-intl. Supports ISR, middleware with auth callbacks, and automatic CDN fetching. See SDK Integration.
Building with Vite/TanStack Start?
Use @better-i18n/use-intl for React hooks or full SSR support with TanStack Start. See SDK Integration.
Using AI coding assistants (Claude, Cursor)? Install the MCP server via MCP Integration. Your agent can create, update, delete keys and add languages directly from your IDE.
Production deployment? Set up CDN Delivery for edge-cached translations. Manifest caches for 5 minutes, messages for 1 hour. Combine with GitHub Sync for version-controlled deployments.
CI/CD integration?
Use better-i18n check:missing in your pipeline to fail builds when translations are incomplete. See CLI Usage.
Better i18n uses default locale without prefix for SEO:
/about → English (default)
/tr/about → Turkish
/de/about → German
Clean URLs for primary language, SEO-friendly variants with proper hreflang tags for others.
| Resource | Browser Cache | CDN Cache | Invalidation |
|---|---|---|---|
| Manifest | 5 minutes | 5 minutes | On publish |
| Messages | 1 hour | 1 hour | On publish |
| Flags | 1 year | 1 year | Immutable |
Comprehensive DevOps and deployment workflow that orchestrates infrastructure automation, CI/CD pipelines, container orchestration, and cloud deployment. Handles everything from infrastructure as code and pipeline setup to monitoring, scaling, and disaster recovery.
Integrate avnu SDK for Starknet DeFi: token swaps with best-price routing, DCA recurring buys, native staking, gasless transactions via paymaster, and market data. Use when building Starknet trading, DEX aggregation, or DeFi automation features.
发布内容和文章到 X (Twitter)。支持带图片的普通推文和 X Articles（长文）。使用真实的 Chrome 和 CDP 来绕过自动化检测。
Master orchestrator for generating Ralph Wiggum-compatible prompts. Analyzes task requirements and routes to appropriate generator (single-task, multi-task, project, or research). Use when you need to create any Ralph loop prompt and want automatic selection of the right generator.
Use when the user asks to compare branches, analyze git diffs, review changes between branches, update specifications based on code changes, or analyze what changed. Triggers on keywords like "compare branches", "git diff", "what changed", "branch comparison", "code changes", "spec update".
Build high-performance FastAPI applications with async routes, validation, dependency injection, security, and automatic API documentation. Use when developing modern Python APIs with async support, automatic OpenAPI documentation, and high performance requirements.
Enables Claude to manage Zendesk Chat conversations, support tickets, and customer service operations
Mine transcripts for knowledge - decisions, learnings, failures, patterns. Triggers: "forge insights", "mine transcripts", "extract knowledge".
Track product analytics and user behavior with Mixpanel's event-based platform.
OCPP protocol reference for EV charging infrastructure development. Covers OCPP 2.0.1 and OCPP 1.6J. Use when working with OCPP messages, charging station code, CSMS/Central System backends, smart charging, transaction handling, or EV charging protocols. Activates on keywords: OCPP, charging stat...
Gather scattered ideas into organized GitHub issues. The bee collects pollen from every flower, checks if the hive already has it, and carefully deposits new work in the comb for later. Never edits code—only organizes the work ahead. Use when creating issues from TODOs or planning work.
Comprehensive best practices for React Native and Expo applications. Contains rules across multiple categories covering performance, animations, UI patterns, and platform-specific optimizations.
Generate, edit, and beat-sync AI video with leading models in one workspace.
The world's fastest calendar for remote work
Transform Your Design with AI Designer by ImgCreator.ai
Revolutionizing Video Production with AI-Powered Creativity
Extend an image past the frame and let AI fill the new aspect ratio.
Discover your celebrity doppelgänger with StarByFace!
ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.
Opus.ai: Revolutionize Your Web Experience