Wrap strings for Lingui with runtime message fallbacks

Lingui, like react-intl, generates catalogs from source with lingui extract. Polyglot therefore wraps with Lingui's documented runtime-fallback shape — the message travels with the call:

The transformation

Before — src/app/page.tsx

"use client";

export default function Page() {
    return (
        <main>
            <h1>Welcome back</h1>
            <p>Your projects are ready</p>
            <input placeholder="Search projects" />
        </main>
    );
}

After — src/app/page.tsx

"use client";
import { useLingui } from "@lingui/react";

export default function Page() {
  const { i18n } = useLingui();
    return (
        <main>
            <h1>{i18n._("src.app.page.welcome_back", {}, { message: "Welcome back" })}</h1>
            <p>{i18n._("src.app.page.your_projects_are_ready", {}, { message: "Your projects are ready" })}</p>
            <input placeholder={i18n._("src.app.page.search_projects", {}, { message: "Search projects" })} />
        </main>
    );
}

The third argument's message renders when the ID isn't in the active catalog — new strings are correct in production from the moment the wrap lands.
useLingui() is injected where needed; rich inline formatting uses Lingui's <Trans> component, whose children are the message.
lingui extract picks the calls up like hand-written ones.

Catalog output

Written — messages/en.json

{
  "src.app.page.search_projects": "Search projects",
  "src.app.page.welcome_back": "Welcome back",
  "src.app.page.your_projects_are_ready": "Your projects are ready"
}

Translated — messages/de.json

{
  "src.app.page.search_projects": "Projekte suchen",
  "src.app.page.welcome_back": "Willkommen zurück",
  "src.app.page.your_projects_are_ready": "Ihre Projekte sind bereit"
}

Translated — messages/fr.json

{
  "src.app.page.search_projects": "Rechercher des projets",
  "src.app.page.welcome_back": "Bon retour",
  "src.app.page.your_projects_are_ready": "Vos projets sont prêts"
}

✓ 3 strings auto-wrapped · 0 flagged for manual review · 0 unsafe transforms → polyglot-i18n-report.md

✓ wiring checks passed (1 injected import(s), 3 catalog value(s), 1 catalog file(s))

Try it

$ curl -fsSL https://getpolyglot.ai/install.sh | bash
$ polyglot init --framework nextjs
$ polyglot scan
$ polyglot wrap
$ polyglot translate --languages de   # 50 strings free, no signup

Wrap strings for Lingui with runtime message fallbacks

The transformation

Catalog output

Try it

Weiterlesen

Schluss mit der Suche nach unübersetzten Strings.