Quick Start

A self-contained example. Copy, paste, run.

1. Install

npm install ilingo

2. Create an instance

import { Ilingo, MemoryStore } from 'ilingo';

const ilingo = new Ilingo({
    store: new MemoryStore({
        data: {
            en: {
                cart: {
                    greeting: 'Welcome, {{name}}!',
                    items: {
                        '@plural': {
                            one: '{{count}} item in your cart',
                            other: '{{count}} items in your cart',
                        },
                    },
                },
            },
            de: {
                cart: {
                    greeting: 'Willkommen, {{name}}!',
                    items: {
                        '@plural': {
                            one: '{{count}} Artikel im Warenkorb',
                            other: '{{count}} Artikel im Warenkorb',
                        },
                    },
                },
            },
        },
    }),
    locale: 'en',
});

3. Translate

await ilingo.get({
    group: 'cart',
    key: 'greeting',
    data: { name: 'Peter' },
});
// "Welcome, Peter!"

await ilingo.get({
    group: 'cart',
    key: 'items',
    count: 3,
});
// "3 items in your cart"

await ilingo.get({
    group: 'cart',
    key: 'greeting',
    locale: 'de',
    data: { name: 'Peter' },
});
// "Willkommen, Peter!"

That's it. The same call works with a file-system store, in a Vue app, and against a typed catalog — the API does not change.

Where to go next

• Stores — the IStore port and how to write your own.
• Locales & Fallback — how pt-BR finds en automatically.
• Pluralization — the @plural marker and definePlural.
• Formatters — {{value, number(...)}} and friends.
• Type-Safe Keys — defineCatalog() + Ilingo<typeof catalog>.