← Semua picks

Stack Comparison Depends on use case

i18next vs Paraglide vs Lingui: i18n React Bahasa Indonesia

i18n React Bahasa Indonesia: i18next vs Paraglide vs Lingui soal type safety, bundle size, SSR, Next.js/Astro, plus format Rupiah dan plural.

28 Oktober 2026 · 10 menit ·Use case: Choosing an i18n library for a React, Next.js or Astro app that ships Bahasa Indonesia and English (and sometimes Javanese or Sundanese), judged on type safety, bundle size, SSR, framework support, translator workflow, and how each one handles plurals, Rupiah, dates and fallback.
i18nextreact-i18nextParaglide JSLinguiIntl API

Sembilan puluh delapan tahun lalu, para pemuda di Batavia menutup Kongres Pemuda Kedua dengan tiga ikrar. Ikrar ketiga adalah kalimat yang patut dibaca pelan-pelan oleh setiap engineer yang membangun produk untuk negeri ini: “Kami poetera dan poeteri Indonesia mendjoendjoeng bahasa persatoean, bahasa Indonesia.” Perhatikan kata kerjanya. Dua ikrar pertama bicara soal satu tanah air dan satu bangsa. Ikrar ketiga tidak bilang kita hanya boleh berbicara satu bahasa. Ia bilang kita menjunjung bahasa persatuan. Itu tafsiran saya, bukan bunyi harfiah naskahnya, tapi bahasa daerah memang tidak pernah diminta hilang.

Tafsiran itu cocok sekali dengan cara aplikasi produksi memperlakukan bahasa. Bahasa Indonesia adalah default yang harus benar di mana-mana. Bahasa Inggris untuk investor, expat, dan sesekali pelanggan enterprise. Bahasa Jawa atau Sunda mungkin muncul di kampanye atau fitur komunitas, dan kalau ada string yang belum diterjemahkan, ia harus jatuh ke Bahasa Indonesia, bukan langsung ke Inggris. Kalau kamu sedang menimbang i18n React Bahasa Indonesia (atau untuk Next.js dan Astro), rantai fallback itu, format Rupiah, dan aturan plural Indonesia adalah ujian sebenarnya. Bukan demo hello-world di beranda tiap library.

Saya backend engineer, jadi saya membandingkan i18next, Paraglide JS dan Lingui seperti mereview dependency di pull request: apa yang dikerjakannya saat runtime, berapa ongkosnya, dan apa yang pecah di SSR. Contoh kode di bawah mengikuti dokumentasi resmi masing-masing library pada versi mayor terbaru saat artikel ini ditulis (Oktober 2026): Lingui 5, Paraglide JS 2, dan i18next seri terbaru. Anggap sebagai titik awal, bukan hasil uji untuk setiap versi minor. API bergerak, jadi kunci versi dan baca changelog-nya.

Apa arti “mendukung Bahasa Indonesia” untuk i18n di React

Setiap library mengklaim mendukung Bahasa Indonesia. Pengalaman saya, bug muncul di empat tempat:

  1. Plural. CLDR memberi Bahasa Indonesia tepat satu kategori plural: other. “1 barang” dan “5 barang” memakai bentuk yang sama. Kedengarannya memudahkan, tapi artinya kode berbahasa Inggris yang penuh ternary count === 1 ? 'item' : 'items' salah begitu diterjemahkan.
  2. Rupiah. Intl.NumberFormat dengan currency: 'IDR' menambahkan ,00 secara default, karena ISO 4217 mencatat dua digit minor untuk IDR. Hampir tidak ada label harga di Indonesia yang menampilkan sen.
  3. Tanggal dan zona waktu. Server yang me-render dalam UTC dan browser dalam WIB akan berbeda pendapat soal tanggal antara 00:00 dan 07:00 WIB. Itu hydration mismatch yang tinggal menunggu waktu.
  4. Fallback. Key Bahasa Jawa yang hilang seharusnya mendarat di Bahasa Indonesia. Tidak semua library bisa mengekspresikannya.

Format Rupiah dengan Intl: aturan satu modul

Sebelum membandingkan library, tetapkan satu aturan: format angka dan tanggal adalah tugas Intl. Ketiga library toh mendelegasikannya ke Intl. Saya simpan satu modul kecil yang dipanggil semua library, supaya format konsisten siapa pun pemenangnya:

// src/lib/format.ts
const rupiah = new Intl.NumberFormat('id-ID', {
  style: 'currency',
  currency: 'IDR',
  minimumFractionDigits: 0,
  maximumFractionDigits: 0,
});

export function formatRupiah(amount: number): string {
  return rupiah.format(amount); // "Rp 1.250.000" (spasinya U+00A0)
}

export function formatTanggal(date: Date, locale = 'id-ID'): string {
  return new Intl.DateTimeFormat(locale, {
    dateStyle: 'long',
    timeZone: 'Asia/Jakarta',
  }).format(date); // "28 Oktober 2026"
}

Tiga catatan penting:

  • Jarak antara Rp dan angka adalah non-breaking space (U+00A0), bukan spasi biasa. Snapshot test yang ditulis dengan spasi biasa akan gagal, dan seseorang akan kehilangan satu sore untuk itu.
  • Kalau desainer minta Rp1.250.000 tanpa spasi, pakai rupiah.formatToParts(amount), buang bagian literal, lalu gabungkan sisanya.
  • formatRupiah sengaja memaku id-ID. Kalau IDR diformat dengan locale en-US, hasilnya IDR 1,250,000. Menurut saya format mata uang mengikuti pasar, bukan bahasa UI: pengguna berbahasa Inggris di Karawaci tetap membayar dalam Rupiah dan membaca Rp. Putuskan sebagai kebijakan tim, lalu tuliskan.

Set timeZone secara eksplisit (Asia/Jakarta, Asia/Makassar atau Asia/Jayapura) untuk apa pun yang dirender di server, atau simpan zona pengguna dan teruskan. Jangan pernah mengandalkan zona default server.

Tabel perbandingan

Dimensioni18next (+ react-i18next)Paraglide JS 2Lingui 5
ModelRuntime dictionary lookupCompiler: each message becomes an ESM functionExtract + compile catalogs, macros in code
Type safetyOpt-in via CustomTypeOptions declarationGenerated, keys and params checked by defaultMacros check syntax; IDs are generated, not hand-typed
Bundle behaviorRuntime plus whole namespaces you loadUnused messages tree-shaken by the bundlerSmall runtime plus compiled catalog per locale
Plural syntaxKey suffixes (_one, _other)Variants with plural selector (ICU via plugin)ICU MessageFormat
Custom fallback chain (jv to id to en)Yes, fallbackLng objectNo, BCP 47 parent or base locale onlyYes, fallbackLocales at compile time
SSR concurrencycreateInstance() per requestBuilt-in middleware with AsyncLocalStoragesetupI18n() per request
Next.jsWell-trodden (App Router guides, next-i18next for Pages)Not in current official guidesDocumented, uses SWC plugin
AstroWorks as plain JS in frontmatterOfficial guideCore works anywhere; macros need build setup
Translator formatJSON, supported by most TMSinlang JSON, plugins for i18next/ICU/XLIFFPO (default), with source text and code references

i18next: pekerja keras berbasis runtime

i18next adalah jawaban default dengan alasan kuat: jalan di mana saja, hampir semua translation management system (TMS) bisa mengimpor JSON-nya, dan react-i18next sudah matang. Ia juga satu-satunya dari tiga yang bisa menulis rantai fallback bahasa daerah langsung di konfigurasi.

// src/i18n.ts
import i18n from 'i18next';
import { initReactI18next } from 'react-i18next';
import en from './locales/en/translation.json';
import id from './locales/id/translation.json';
import jv from './locales/jv/translation.json';

void i18n.use(initReactI18next).init({
  lng: 'id',
  supportedLngs: ['en', 'id', 'jv'],
  fallbackLng: { jv: ['id', 'en'], default: ['en'] },
  resources: {
    en: { translation: en },
    id: { translation: id },
    jv: { translation: jv },
  },
  interpolation: { escapeValue: false }, // React sudah meng-escape
});

export default i18n;

locales/en/translation.json:

{ "cart_one": "{{count}} item in your cart", "cart_other": "{{count}} items in your cart", "total": "Total: {{amount}}" }

locales/id/translation.json:

{ "cart_other": "{{count}} barang di keranjang", "total": "Total: {{amount}}" }

Bahasa Indonesia cukup punya cart_other, karena Intl.PluralRules('id') tidak pernah mengembalikan one. Berdasarkan dokumentasi fallback i18next, file Jawa yang hanya menerjemahkan cart_other akan mengambil total dari Bahasa Indonesia, bukan Inggris. Cek perilaku ini di versi yang kamu pakai.

import { useTranslation } from 'react-i18next';
import { formatRupiah } from './lib/format';

export function CartSummary({ count, total }: { count: number; total: number }) {
  const { t } = useTranslation();
  return (
    <section>
      <p>{t('cart', { count })}</p>
      <p>{t('total', { amount: formatRupiah(total) })}</p>
    </section>
  );
}

i18next punya format Intl bawaan ("Total: {{amount, currency}}" plus formatParams), tapi ia memakai bahasa yang aktif. Saya lebih suka mengoper string yang sudah diformat dari modul tadi.

Type safety bersifat opt-in dan bekerja baik setelah disiapkan:

// src/i18next.d.ts
import 'i18next';
import type en from './locales/en/translation.json';

declare module 'i18next' {
  interface CustomTypeOptions {
    defaultNS: 'translation';
    resources: { translation: typeof en };
  }
}

Sekarang t('crat') jadi error kompilasi. Tapi ia tetap tidak memberi tahu kalau id/translation.json kehilangan key, jadi tambahkan pemeriksaan di CI.

Jebakan SSR: ekspor default i18next adalah singleton. Di server Node yang melayani request bersamaan, memanggil changeLanguage pada singleton itu bisa membuat locale satu pengguna bocor ke respons pengguna lain. Pakai i18next.createInstance() per request. Ini bug yang paling sering saya temui di code review.

Biaya bundle: kamu mengirim runtime plus semua namespace yang dimuat, terpakai atau tidak. Pecah namespace per route, muat secara lazy, dan ukur dengan analyzer bundler-mu, bukan percaya blog siapa pun, termasuk yang ini.

Paraglide JS: pesan sebagai fungsi hasil kompilasi

Paraglide, dari proyek inlang, mengambil pendekatan sebaliknya. Compiler mengubah file pesan jadi satu fungsi bertipe per pesan, dan bundler membuang yang tidak pernah diimpor. Setup dimulai dengan npx @inlang/paraglide-js init, yang membuat project.inlang/settings.json dan folder messages/.

messages/en.json:

{
  "cart_items": [{
    "declarations": ["input count", "local countPlural = count: plural"],
    "selectors": ["countPlural"],
    "match": {
      "countPlural=one": "{count} item in your cart",
      "countPlural=other": "{count} items in your cart"
    }
  }],
  "order_total": [{
    "declarations": [
      "input amount",
      "local formatted = amount: number style=currency currency=IDR minimumFractionDigits=0 maximumFractionDigits=0"
    ],
    "match": { "*": "Total: {formatted}" }
  }]
}

messages/id.json (lengkap, deklarasi order_total sama dengan versi Inggris):

{
  "cart_items": [{
    "declarations": ["input count", "local countPlural = count: plural"],
    "selectors": ["countPlural"],
    "match": { "countPlural=other": "{count} barang di keranjang" }
  }],
  "order_total": [{
    "declarations": [
      "input amount",
      "local formatted = amount: number style=currency currency=IDR minimumFractionDigits=0 maximumFractionDigits=0"
    ],
    "match": { "*": "Total: {formatted}" }
  }]
}
import { m } from './paraglide/messages.js';

export function CartSummary({ count, total }: { count: number; total: number }) {
  return (
    <section>
      <p>{m.cart_items({ count })}</p>
      <p>{m.order_total({ amount: total })}</p>
    </section>
  );
}

Type safety di sini bawaan, bukan tambahan: salah ketik nama pesan atau lupa count, TypeScript langsung menghentikanmu. Locale juga bisa di-override per panggilan (m.cart_items({ count }, { locale: 'id' })), berguna untuk email dan job server. Kalau kamu lebih suka sintaks ICU, plugin ICU dari inlang memungkinkan {count, plural, other {# barang}}.

Soal fallback: menurut dokumentasi, pesan yang hilang di suatu locale dicari lewat BCP 47 (id-ID jatuh ke id), lalu ke baseLocale. Artinya jv.json tanpa cart_items akan menampilkan string Inggris, bukan Indonesia. Tidak ada rantai jv → id. Konfirmasi di proyekmu dengan satu test kecil. Kalau bahasa Jawa atau Sunda penting, jadikan id sebagai base locale (yang memang saya sarankan untuk produk Indonesia-first) atau perlakukan key daerah yang hilang sebagai kegagalan CI.

SSR ditangani dengan baik: paraglideMiddleware dari server.js hasil generate memakai AsyncLocalStorage, jadi getLocale() ter-resolve per request tanpa bocor. Catatan: setLocale() di browser secara default melakukan navigasi dokumen penuh, bukan re-render di tempat. Aman untuk situs konten, tapi bisa mengejutkan tim SPA.

Framework: panduan resmi mencakup Vite, SvelteKit, TanStack Start, React Router, Vue dan Astro. Next.js belum masuk daftar. Ukuran bundle adalah jualan utama Paraglide: benchmark yang dipublikasikan sendiri oleh proyeknya melaporkan 47 KB untuk Paraglide vs 205 KB untuk i18next pada 5 locale dan 200 pesan. Angka itu klaim vendor dan saya tidak mereproduksinya. Mekanismenya (tree-shaking per pesan) nyata, tapi ukur aplikasimu sendiri. Ini penting terutama untuk pengguna ponsel Android kelas menengah dengan data seluler yang terbatas.

Lingui: ICU dan file PO, dibuat untuk penerjemah

Lingui ada di tengah. Kamu menulis source text di komponen lewat macro, lingui extract mengumpulkannya ke katalog (PO secara default), dan lingui compile mengubahnya jadi modul JS kecil. Konfigurasi fallback-nya mendukung rantai yang saya mau:

// lingui.config.ts
import type { LinguiConfig } from '@lingui/conf';

const config: LinguiConfig = {
  sourceLocale: 'en',
  locales: ['en', 'id', 'jv'],
  fallbackLocales: { jv: ['id', 'en'], default: 'en' },
  catalogs: [{ path: '<rootDir>/src/locales/{locale}/messages', include: ['src'] }],
};

export default config;
import { Plural, Trans } from '@lingui/react/macro';
import { formatRupiah } from './lib/format';

export function CartSummary({ count, total }: { count: number; total: number }) {
  const amount = formatRupiah(total);
  return (
    <section>
      <p><Plural value={count} one="# item in your cart" other="# items in your cart" /></p>
      <p><Trans>Total: {amount}</Trans></p>
    </section>
  );
}

Menyimpan amount ke variabel dulu itu penting: penerjemah melihat placeholder bernama {amount}, bukan {0}. Di file PO Indonesia, plural menjadi {count, plural, other {# barang di keranjang}}. Dengan msgstr Jawa yang kosong, lingui compile mengisinya dari Bahasa Indonesia sesuai konfigurasi fallbackLocales.

Pemuatan katalog tetap eksplisit, dan itu disukai bundler:

// src/i18n.ts
import { i18n } from '@lingui/core';

const loaders = {
  en: () => import('./locales/en/messages'),
  id: () => import('./locales/id/messages'),
  jv: () => import('./locales/jv/messages'),
} as const;

export type Locale = keyof typeof loaders;

export async function activate(locale: Locale) {
  const { messages } = await loaders[locale]();
  i18n.loadAndActivate({ locale, messages });
}

Bungkus aplikasi dengan <I18nProvider i18n={i18n}> dari @lingui/react. Di server, buat instance per request dengan setupI18n(), aturan yang sama seperti i18next. Lingui juga punya i18n.number() dan i18n.date() yang, seperti i18next, mengikuti locale aktif.

Ongkosnya ada di tooling build. Macro butuh transform Babel atau SWC. Di Next.js artinya @lingui/swc-plugin, dan plugin SWC harus cocok dengan versi swc_core yang dibawa rilis Next.js-mu. Cek catatan kompatibilitas setiap kali upgrade Next. Imbalannya ada di alur kerja penerjemah: file PO membawa kalimat sumber, komentar konteks, dan referensi file. Poedit, Weblate dan Crowdin menangani PO secara native, dan lingui extract menampilkan berapa pesan yang masih kosong per locale.

i18next vs Lingui vs Paraglide untuk i18n React Bahasa Indonesia, per kriteria

  • Type safety: Paraglide bawaan. i18next bagus setelah ada file deklarasi. Lingui menghindari sebagian besar salah ketik key karena memang tidak ada key tulisan tangan.
  • Ukuran bundle: Di atas kertas Paraglide menang. Katalog hasil kompilasi Lingui ramping. i18next paling berat, dan pemecahan namespace adalah tuas utamamu.
  • SSR: ketiganya bisa aman. Middleware Paraglide paling sulit disalahgunakan. Di i18next dan Lingui, instance per request jadi tanggung jawabmu.
  • Astro dan Next.js: untuk website multi bahasa di Next.js dan Astro dalam satu perusahaan, i18next satu-satunya dengan jalur nyaman di keduanya. Hanya Astro? Paraglide plus routing i18n bawaan Astro (locales, defaultLocale, fallback: { jv: 'id' }) adalah kombinasi yang rapi. Ingat, fallback Astro menangani halaman yang hilang, bukan string yang hilang.
  • Alur kerja penerjemah: Lingui kalau penerjemahmu hidup di tool PO. i18next kalau kamu memakai TMS hosted. Paraglide kalau tim nyaman dengan tooling inlang atau bisa memetakan JSON-nya ke TMS lewat plugin.

Satu test yang selalu saya tambahkan

import { expect, test } from 'vitest';
import { formatRupiah } from './lib/format';

test('Rupiah tanpa desimal dan memakai non-breaking space', () => {
  expect(formatRupiah(1250000)).toBe('Rp 1.250.000');
  expect(new Intl.PluralRules('id').resolvedOptions().pluralCategories).toEqual(['other']);
});

Kalau backend-mu Java, ada satu jebakan lagi: JDK sebelum 17 menormalkan id ke kode lama in, jadi string locale dari service Spring lama bisa tidak cocok dengan id di frontend. Normalkan di batas API.

Pilih mana?

Pilih i18next kalau:

  • Kamu menjalankan Next.js dan Astro (atau React Native) berdampingan dan ingin satu library di mana-mana
  • Kamu butuh rantai fallback bahasa daerah kustom saat runtime
  • Vendor terjemahanmu sudah paham JSON i18next

Pilih Paraglide JS kalau:

  • Aplikasimu berbasis Vite atau Astro, dan ukuran bundle di ponsel Android kelas menengah dengan data seluler benar-benar kendala
  • Kamu ingin type safety tanpa setup tambahan
  • Bahasa Indonesia bisa jadi baseLocale, sehingga fallback key yang hilang mendarat di tempat yang kamu mau

Pilih Lingui kalau:

  • Penerjemah atau reviewer bekerja di file PO dan ingin melihat kalimat asli beserta konteks
  • Kamu mau plural ICU dan fallback saat compile (jv → id → en)
  • Kamu sanggup memegang setup macro Babel atau SWC, termasuk saat upgrade Next.js

Untuk kebanyakan tim produk Indonesia-first, saya akan mulai dari Bahasa Indonesia sebagai sumber kebenaran, Intl untuk setiap angka dan tanggal, dan library yang fallback serta tooling-nya cocok dengan cara kerja penerjemahmu. Library itu bagian yang mudah diganti. formatRupiah yang salah di empat puluh tempat tidak. Langkah praktis hari ini: salin test Rupiah di atas ke CI-mu, lalu jalankan. Junjung bahasa persatuan di locale default, dan beri ruang bagi bahasa daerah untuk jatuh dengan mulus.

Ditulis oleh Reza Pradipta

// Pick Stack Comparison lain


← Semua picks RSS feed