Ein Befehl von hartcodierten Strings zur lokalisierten App

KI-Coding-Tools haben verändert, wer Software ausliefert. Eine an einem Nachmittag mit v0, Lovable, Bolt oder Cursor gebaute App wirkt fertig, bis jemand nach einer zweiten Sprache fragt und Sie feststellen, dass jeder String hartcodiert ist. Nachträglich zu internationalisieren bedeutete bisher ein Wochenende: Strings verpacken, i18next verdrahten, Projekt anlegen, Sprachen hinzufügen, Dateien herumschieben.

Jetzt ist es ein Befehl:

npx i18next-cli localize

Der neue localize-Superbefehl in i18next-cli 1.62 verkettet die ganze Reise (erkennen, instrumentieren, extrahieren, mit Locize verbinden, KI-übersetzen, ausliefern) und endet mit einer lokalisierten, laufenden App.

Wie ein Lauf aussieht

$ npx i18next-cli localize
i18next-cli localize — from hardcoded strings to a localized app

[1/6] Detecting project…
      ✔ react + TypeScript
[2/6] Configuration…
      ✔ locales: en, de, fr, it
[3/6] Instrumenting code…
      ✔ 96/101 candidate string(s) instrumented (5 skipped).
[4/6] Extracting translation keys…
      ✔ Translation keys extracted.
[5/6] Connecting to Locize…

  One manual step — in your browser:
    1. Sign up / log in
    2. Create a project. Your target languages (en, de, fr, it) are
       created automatically on the first sync.
    3. Copy your Project ID and an API key.

[6/6] Translating & delivering…
      ✔ Synced to Locize with AI auto-translate requested.
      Waiting for AI translations to arrive…
        de: 96/96 (100%)
        fr: 96/96 (100%)
        it: 96/96 (100%)
      ✔ All languages translated and downloaded.

✅ Done. Your app is localized.

Your AI translations come with confidence scores; low-confidence ones
are flagged for review in Locize.

Schritt 5 ist der einzige manuelle Moment im gesamten Ablauf: bei Locize registrieren, Projekt anlegen, zwei Zugangsdaten einfügen. Alles andere passiert automatisch, einschließlich des Anlegens Ihrer Zielsprachen. Wenn Ihre Konfiguration oder Umgebung bereits LOCIZE_PROJECTID/LOCIZE_API_KEY enthält, entfällt sogar dieser Schritt.

Was gerade passiert ist

1. Erkennen: Framework (React und Next.js nativ), TypeScript, ein etwaiges bestehendes i18next-Setup.
2. Konfiguration: nutzt Ihre i18next.config.ts oder startet den interaktiven init-Assistenten, falls keine existiert.
3. Instrumentieren: verpackt hartcodierte Strings in t()-Aufrufe und <Trans>-Komponenten und injiziert useTranslation(), wo nötig. Standardmäßig interaktiv: Sie genehmigen jede Änderung. Das ist der instrument-Befehl, ein Assistent, kein Compiler.
4. Extrahieren: sammelt jeden Schlüssel in Ihre Locale-Dateien.
5. Mit Locize verbinden: geführte Registrierung und kein manuelles Sprach-Setup, denn die Sprachen aus Ihrer Konfiguration werden beim ersten Sync automatisch angelegt (locize-cli ≥ 12.3, die die Locize-Schritte antreibt).
6. Übersetzen & ausliefern: synchronisiert mit KI-Auto-Übersetzung, die bei neuen Projekten standardmäßig aktiviert ist und Ihr Glossar sowie Ihren Styleguide als Kontext nutzt. Der Befehl beobachtet dann das Eintreffen der Übersetzungen, lädt sie herunter und gibt das i18next-locize-backend-CDN-Snippet aus, damit künftige Übersetzungskorrekturen live gehen, ohne dass Sie Ihre App neu deployen.

Das Locize-Projekt nach dem Lauf: alle vier Sprachen auf 100 %, automatisch veröffentlicht.

Und weil Quality Estimation bei neuen Projekten ebenfalls standardmäßig aktiviert ist, kommt jede KI-Übersetzung mit einem Konfidenzwert an; Übersetzungen mit niedriger Konfidenz werden fürs Review markiert, statt stillschweigend live zu gehen. Genau das hat in dieser Demo einen echten Fall gefunden:

Ihr KI-Coding-Agent kann das für Sie ausführen

Die Apps, für die dieser Befehl gebaut ist, wurden oft von einem Agenten geschrieben. Deshalb gibt es den Ablauf auch als Prompt:

npx i18next-cli localize --print-agent-prompt

Das gibt Schritt-für-Schritt-Anweisungen für Claude Code, Cursor oder jeden anderen Coding-Agenten aus, mit den einzelnen CLI-Befehlen (instrument --dry-run, extract, locize-sync, …) statt des interaktiven Superbefehls. Der Prompt ist versionsgenau auf Ihre installierte CLI abgestimmt und weicht so nie von dem ab, was localize selbst tut. Fügen Sie ihn in Ihren Agenten ein, übergeben Sie auf Nachfrage die zwei Locize-Zugangsdaten und prüfen Sie am Ende den Diff.

Ehrliche Grenzen

• Prüfen Sie den Instrument-Diff. Die Instrumentierung ist aus gutem Grund heuristisch und interaktiv: Genehmigen Sie Änderungen pro String und rechnen Sie damit, einige anzupassen (Markennamen, dynamische Labels). Ein unsauberer Git-Arbeitsbaum löst zuerst eine Bestätigungsabfrage aus, und --dry-run zeigt alles als Vorschau, ohne zu schreiben.
• Next.js App Router: instrument injiziert useTranslation(), das nur clientseitig funktioniert. Prüfen Sie Server-Komponenten im Diff und ergänzen Sie 'use client' oder stellen Sie sie auf ein serverseitiges t()-Muster um.
• Nicht-React-Stacks degradieren sauber. Die Transformation deckt React/JSX von Haus aus ab; für Vue oder Svelte fügen Sie ein Community-Plugin hinzu (i18next-cli-vue, i18next-cli-plugin-svelte). Ohne Plugin wird der Instrument-Schritt mit Hinweisen übersprungen, und der Rest des Ablaufs (Extrahieren → Locize → Auto-Übersetzung) läuft trotzdem.
• Die KI-Übersetzung läuft, sobald das Projekt ein Abo hat oder Ihr eigener KI/MT-Anbieter-Schlüssel hinterlegt ist. Der Sync selbst funktioniert in beiden Fällen, und ein späterer erneuter Lauf von localize bringt die Sache zu Ende: Der Befehl ist idempotent, abgeschlossene Schritte werden einfach übersprungen.

Loslegen

In Ihrem Projektverzeichnis:

npx i18next-cli localize

Oder zuerst als Vorschau mit npx i18next-cli localize --dry-run. Die vollständige Optionsreferenz (CI-Modus, --skip-instrument, Namespaces, …) steht im i18next-cli-README, die Locize-Seite in der CLI-Dokumentation.

Wenn Sie die Lokalisierung wegen der Verkabelung aufgeschoben haben: Die Verkabelung ist weg. Erstellen Sie ein kostenloses Locize-Konto und führen Sie den Befehl aus.