best-i18n

Compile-time i18n. Write the source text inline; the compiler inlines every translation at the call site — no runtime catalog, no lookup, nothing to load.

Get started GitHub

import { useI18n } from 'best-i18n/react/macro'

function About() {
  const t = useI18n()
  return <h1>{t`A small starter with room to grow.`}</h1>
}

// compiled — a ternary, no runtime

function About() {
  const t = useLocale()
  return <h1>{t === 'zh'
    ? `一个小而可长的起始模板。`
    : `A small starter with room to grow.`}</h1>
}

No keys

The source text is the message; ids are content hashes managed for you in PO files.

No runtime

Messages compile to ternaries or plain literals. Unused messages tree-shake with the code that used them.

PO workflow

messages.pot + <locale>.po — the format translators, TMSes and LLMs already understand.

SSR-safe

The server locale lives in AsyncLocalStorage per request; no isolation means an error, never shared state.