Guides

The decisions that actually cost you time.

Not a tutorial index. These are the four questions that get expensive when answered late in a TypeScript i18n project — and each answer here is anchored to something you can re-run from the repository rather than to an opinion.

Follow the guided quickstart Browse the documentation

01 — Guides

Start with the one that is biting you.

Each page names the problem in the terms you would recognise it by, then the approach, then the evidence, then the questions people ask afterwards.

Topic · Server components

i18n for React Server Components, without the workaround.

Why Context-based i18n breaks in the App Router

Read the guide →

Topic · Performance

Extraction should not be the slow part of your build.

Where the time actually goes

Read the guide →

Topic · ICU

'Supports ICU' is not a yes-or-no answer.

Where ICU quietly stops working

Read the guide →

Topic · Routing

Four ways to carry a locale. They are not interchangeable.

The decision people make by accident

Read the guide →

02 — Elsewhere

Looking for something else?

Guides answer a question. These answer a different kind.

Weighing Palamedes against another library

Eight head-to-head comparisons, each opening with what the other project does better.

Checking the claims yourself

Benchmarks, the ICU proof, the verified example matrix and the decision records.

Implementing something specific

The reference documentation: configuration, CLI, API and troubleshooting.

Every guide is backed by something you can re-run.

See the proof Get started