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 skills add globalize-now/globalize-skills --allLass 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.
Verbindung über das MCP (optional)
Möchtest du Globalize lieber von Cursor aus steuern? Sobald dein Code i18n-ready ist, verbinde das MCP.
Füge zu ~/.cursor/mcp.json hinzu
{"mcpServers":{"globalize":{"url":"https://api.globalize.now/mcp"}}}Mehr: verbinde das MCP →
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 über 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 die Erzeugung von Schlüsseln plus Locale-Dateien, nicht darauf, welcher Editor das JSX erzeugt hat. Du führst immer noch `npx skills add globalize-now/globalize-skills` aus dem Projekt-Root aus und folgst den geführten Prompts, damit der Agent das Repo scannen und zusammenführbare 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 `npx skills add globalize-now/globalize-skills` immer aus dem Repository-Root in Cursors integriertem Terminal (oder einer beliebigen Shell, die auf diesen Root zeigt) aus. Die Skills beziehen sich auf das aktuelle Projekt, installieren das Lokalisierungs-Skill-Bundle und geben die Kontrolle an deinen Agent für die folgenden Prompts zurück. Das Bleiben im Root hält die Pfaderkennung mit der Art ausgerichtet, wie die CLI den Baum scannt.
Probiere globalize.now mit Cursor aus
Starte von deinem Projekt-Root:
npx skills add globalize-now/globalize-skills --all