Introduction

ilingo is a small, framework-agnostic translation and internationalization library for TypeScript. It gives you three things and nothing more:

1. An orchestrator (Ilingo) that resolves a key against a locale chain.
2. A port (IStore) with two stock adapters: in-memory and file-system.
3. A template engine for {{var}} substitution plus Intl formatters.

Everything else — pluralization, fallback chains, missing-key handling, framework adapters — composes from those three pieces.

Why ilingo?

• Tiny. The core has two runtime dependencies. ESM-only, browser-safe, no node: imports in the core.
• Pluggable. A custom store is one class implementing three methods.
• Locale-first resolution. A pt-BR request walks pt-BR → pt → en before giving up — and the closest locale wins regardless of which store holds it.
• Standards-aligned. Plurals go through Intl.PluralRules. Formatters delegate to Intl.NumberFormat, Intl.DateTimeFormat, Intl.ListFormat.
• Open-world by design. Keys are loose strings — get() returns Promise<string | undefined>. An app composes several stores (its own catalog plus library catalogs, API- or loader-backed sources), so the legal key set isn't knowable at build time. You author the tree with defineCatalog() and friends; the store walk resolves whatever any registered store can answer.

Where to go next

• Installation — install the packages you need.
• Quick Start — a 30-second example.
• Guide → Overview — the conceptual map.
• Integrations — file system, Vue, Vuelidate.