Getting Started

i18next integration for Expo and React Native with offline caching and instant language switching

Overview

@better-i18n/expo is an i18next integration that pre-loads translations from the better-i18n CDN. It plugs into your existing i18next + react-i18next setup with zero native modules — meaning it works in Expo Go out of the box.

Pre-loaded translations — CDN fetch, caching, and namespace discovery handled automatically
Offline-first — Persistent caching via MMKV or AsyncStorage with network-first strategy
Expo Go compatible — Pure JavaScript, no native modules required
Device locale detection — Auto-detect via expo-localization

initBetterI18n handles everything — CDN fetch, caching, namespace discovery, and language switching. Your existing useTranslation() calls stay exactly the same.

Features

Works in Expo Go

Pure JS implementation — no native modules, no dev client required.

Offline Support

Persistent caching ensures translations are always available, even without network.

Pluggable Storage

Uses MMKV by default, falls back to AsyncStorage, or any custom key-value store.

Device Locale

Auto-detect the user's language via expo-localization.

Instant Language Switching

Translations are pre-loaded before the switch happens — no English flash or loading spinners.

Quick Start

i18n.ts

import i18n from 'i18next';
import { initReactI18next } from 'react-i18next';
import { initBetterI18n } from '@better-i18n/expo'; 

i18n.use(initReactI18next); 

export const { languages } = await initBetterI18n({ 
  project: 'your-org/your-project', 
  i18n,
  defaultLocale: 'en',
  debug: __DEV__,
});

App.tsx

import './i18n';
import { useTranslation } from 'react-i18next';
import { Text } from 'react-native';

function HomeScreen() {
  const { t } = useTranslation();
  return <Text>{t('welcome')}</Text>;
}

Guide

Setup

Installation, configuration, and language switching.

Offline & Caching

How persistent caching and offline fallback works.

Dynamic CFBundleLocalizations

Sync iOS locale support automatically from your CDN manifest.

API Reference

Complete API documentation for all exports.

Comparison

Feature	Expo	Vite	TanStack Start	Next.js
Rendering	Client	Client	Client + SSR	Client + SSR
i18n library	i18next	use-intl	use-intl	next-intl
Offline support	Built-in	Manual	Manual	Manual
Expo Go	Yes	N/A	N/A	N/A
Persistent cache	MMKV / AsyncStorage	N/A	N/A	N/A

Choose Expo for React Native / Expo apps. For web apps, see Vite, TanStack Start, or Next.js.