Getting Started

Native Flutter i18n with the better_i18n Dart SDK — CDN-driven translations with offline support.

Overview

better_i18n is a pure Dart + Flutter SDK that loads translations from the better-i18n CDN at runtime. It uses the same CDN infrastructure as the Expo and iOS SDKs — meaning your translations are managed in one place and delivered to all platforms.

CDN-driven — Translations update without app store releases
Offline-first — 4-tier fallback: memory → CDN → persistent storage → static data
Reactive UI — BetterI18nProvider rebuilds widgets automatically on locale change
No codegen — No build steps, no generated files, no native modules

BetterI18nProvider handles everything — CDN fetch, caching, locale switching, and loading/error states. Use context.t('key') anywhere in the widget tree.

Integrating with AI? Run npx skills add better-i18n/skills first — your agent (Cursor, Claude Code, or Windsurf) will already know the SDK patterns, CDN behavior, and key conventions. Then just ask it to set up the integration for you. Learn more →

Features

Offline-First

4-tier fallback chain ensures translations are always available — even without network.

Reactive UI

Locale switches rebuild the widget tree instantly via ChangeNotifier.

Locale Switching

context.setI18nLocale('tr') — pre-loads translations before switching.

Testing Utilities

MemoryStorage and BetterI18nScope make widget testing straightforward.

No Codegen

Pure Dart — no build_runner, no generated files, no native modules required.

Quick Start

pubspec.yaml

dependencies:
  better_i18n: ^0.1.0

lib/main.dart

import 'package:better_i18n/better_i18n.dart';
import 'package:flutter/material.dart';

void main() {
  runApp(
    BetterI18nProvider(
      project: 'your-org/your-project', 
      defaultLocale: 'en',
      child: const MyApp(),
    ),
  );
}

lib/home_screen.dart

import 'package:better_i18n/better_i18n.dart';
import 'package:flutter/material.dart';

class HomeScreen extends StatelessWidget {
  const HomeScreen({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Text(context.t('common.welcome')), 
            Text(context.t('common.greeting', args: {'name': 'Osman'})), 
          ],
        ),
      ),
    );
  }
}

Guide

Setup

Installation, configuration, and locale switching.

Offline & Caching

How the 4-tier fallback chain and persistent storage work.

API Reference

Complete API documentation for all exports.

Comparison

Feature	Flutter	Expo	iOS
Language	Dart	TypeScript	Swift
i18n library	better_i18n	i18next	better-i18n-ios
UI framework	Flutter widgets	React Native	SwiftUI / UIKit
Offline support	Built-in	Built-in	Built-in
Reactive rebuilds	ChangeNotifier	React state	@Observable / ObservableObject
Persistent cache	SharedPrefsStorage	MMKV / AsyncStorage	UserDefaults
No codegen	Yes	Yes	Yes

Choose Flutter for cross-platform mobile apps written in Dart. For React Native / Expo apps, see Expo. For native iOS, see iOS.