globalize.now mit Cursor verwenden
Extrahiere Strings und generiere Locale-Dateien aus Cursor-erstellten Apps mit einem Befehl.
Cursor generiert funktionierende UI schnell, hartcodiert aber typischerweise Englisch direkt in JSX. globalize.now extrahiert diese hartcodierten Strings, generiert Übersetzungsschlüssel und erstellt Locale-Dateien – und verwandelt eine Cursor-erstellte App in eine übersetzungsbereite Codebase. Die Einrichtung dauert einen Befehl und synchronisiert sich danach bei jedem Git-Push.
Voraussetzungen
- Ein mit Cursor erstelltes Projekt
- Ein Git-Repository
- Node.js 18+
- Eine beliebige JavaScript-i18n-Bibliothek installiert (i18next, next-intl und ähnliche) oder keine, wenn du von vorne anfängst
So richtest du globalize.now mit Cursor ein
Öffne dein Cursor-Projekt und bestätige Git
Öffne das Repository in Cursor und stelle sicher, dass deine Codebase committed und zu einem Git-Remote gepusht ist, damit spätere Pushes Sync auslösen können.
Führe den Skills-Installer im Projekt-Root aus
Installiere im Terminal im Repository-Root die Globalize-Agent-Skills, damit dein Assistent i18n scaffolden und den Tree scannen kann.
npx globalize-skillsLass den Agent die Codebase analysieren
Folge den Agent-Prompts, damit er hartcodierte benutzerfreundliche Strings über deine Komponenten und Routes hinweg lokalisieren kann.
Überprüfe das vorgeschlagene Übersetzungsschlüssel-Layout
Inspiziere die vorgeschlagene Schlüsselstruktur und Benennung, bevor Refactors in deinen Branch landen.
Bestätige Extraktion und Locale-Dateien
Genehmige die Änderungen, damit Schlüssel generiert werden, Komponenten deine i18n-Runtime-API statt Literals aufrufen und Locale-Dateien ins Repo geschrieben werden.
Commit und Push
Committe die Änderungen und pushe auf deinen Standard-Branch, damit globalize.now neue Strings bei zukünftigen Git-Pushes ausgerichtet halten kann.
Häufige Probleme
Cursor fügt weiterhin neue hartcodierte Strings hinzu
Lösung: globalize.now läuft bei jedem Git-Push, sodass neue Literals automatisch erkannt werden, statt sich zwischen Releases stillschweigend anzusammeln.
Übersetzungsschlüssel konfligieren mit einem bestehenden i18n-Setup
Lösung: globalize.now erkennt bestehende i18n-Bibliotheken und folgt ihren Konventionen, sodass neue Schlüssel deinen aktuellen Katalog erweitern, statt dagegen anzukämpfen.
Häufig gestellte Fragen
Funktioniert globalize.now mit jedem Cursor-generierten Projekt?
Ja, solange der Stack einer ist, den globalize.now durch seine Agent-Skills unterstützt (moderne JavaScript-Frameworks wie Next.js, React oder Vue). globalize.now konzentriert sich auf das Extrahieren hartcodierter UI-Strings und das Produzieren von Schlüsseln plus Locale-Dateien, nicht darauf, welcher Editor die JSX produziert hat. Du führst immer noch npx globalize-skills vom Projekt-Root aus und folgst den geführten Prompts, damit der Agent das Repo scannen und mergbare Diffs öffnen kann.
Muss ich globalize.now konfigurieren, um Cursor-spezifische Muster zu erkennen?
Es ist keine separate Cursor-Integration erforderlich. globalize.now analysiert das Repository auf die gleiche Weise, unabhängig davon, ob Dateien manuell oder von Cursor erstellt wurden. Die Skills suchen nach benutzerfreundlichen Literals und Routing-Struktur und schlagen dann Schlüssel vor, die zur i18n-Bibliothek passen, die du übernimmst. Du überprüfst den Plan in Git wie jede andere Änderung.
Kann ich globalize.now auf einem Cursor-Projekt verwenden, das bereits teilweise i18n hat?
Ja. Das Tooling ist dafür ausgelegt, bestehende Kataloge zu erweitern, wenn Schlüssel und Locale-Dateien bereits vorhanden sind. globalize.now erkennt die Runtime-Bibliothek, die du verwendest, und schlägt Ergänzungen vor, statt frühere Arbeiten zu verwerfen, sodass du Literals inkrementell migrieren kannst. Nutze weiterhin Git-Pushes, damit neue UI abgedeckt bleibt.
Welche i18n-Bibliotheken funktionieren mit globalize.now-Output in einem Cursor-Projekt?
globalize.now ist bibliotheksagnostisch: es produziert strukturierte Schlüssel und Locale-Dateien, die mit gängigen Runtimes wie i18next, next-intl, react-intl, Lingui und vue-i18n funktionieren. Dein Cursor-Projekt behält den Stack, den du wählst; globalize.now liefert die Extraktions- und Sync-Schicht. Die Agent-Skills helfen dabei, den Provider oder die Middleware zu verdrahten, die dein Framework erwartet.
Ändert globalize.now meine Cursor-generierten Komponenten?
globalize.now schreibt Call-Sites um, sodass Literals durch deine i18n-API fließen (z. B. t() oder Message-Komponenten), während das Verhalten erhalten bleibt. Du überprüfst Diffs in Git, bevor du mergst, genau wie jede Cursor-generierte Änderung. Nach dem ersten Merge setzen zukünftige Pushes fort, neue Strings automatisch zu synchronisieren, ohne einen separaten Export-Schritt.
Wo führe ich globalize.now in Cursor aus?
Führe immer npx globalize-skills vom Repository-Root in Cursors integriertem Terminal (oder einer beliebigen Shell, die auf diesen Root zeigt) aus. Die Skills sind auf das aktuelle Projekt beschränkt, installieren das Lokalisierungs-Skill-Bundle und geben die Kontrolle an deinen Agent für die Folge-Prompts zurück. Das Bleiben im Root hält die Pfaderkennung mit der Art ausgerichtet, wie die CLI den Tree scannt.
Probiere globalize.now mit Cursor aus
Starte von deinem Projekt-Root:
npx globalize-skills