Usare globalize.now con Cursor
Estrai stringhe e genera file di traduzione da app costruite con Cursor con un solo comando.
Cursor genera UI funzionante velocemente, ma di solito hardcoda l'inglese direttamente in JSX. globalize.now estrae quelle stringhe hardcoded, genera chiavi di traduzione e crea file di traduzione — trasformando un'app costruita con Cursor in una codebase pronta per la traduzione. La configurazione richiede un comando e si sincronizza a ogni push su Git in seguito.
Prerequisiti
- Un progetto costruito con Cursor
- Un repository Git
- Node.js 18+
- Una libreria i18n JavaScript installata (i18next, next-intl e simili), oppure nessuna se stai iniziando da zero
Come configurare globalize.now con Cursor
Apri il tuo progetto Cursor e conferma Git
Apri il repository in Cursor e assicurati che la tua codebase sia committata e pushata su un remote Git così i push successivi potranno attivare la sincronizzazione.
Esegui l'installer delle skill nella radice del progetto
In un terminale alla radice del repository, installa le skill dell'agente Globalize così il tuo assistente può scaffoldare i18n e scansionare l'albero.
npx globalize-skillsLascia che l'agente analizzi la codebase
Segui i prompt dell'agente così può individuare stringhe hardcoded visibili all'utente nei tuoi componenti e route.
Rivedi il layout proposto delle chiavi di traduzione
Ispeziona la struttura di naming suggerita prima che qualsiasi refactor finisca nel tuo branch.
Conferma estrazione e file di traduzione
Approva le modifiche così le chiavi vengono generate, i componenti chiamano la tua API i18n runtime invece di letterali, e i file di traduzione vengono scritti nel repo.
Committa e pusha
Committa le modifiche e pusha al tuo branch di default così globalize.now può mantenere le nuove stringhe allineate nei push su Git futuri.
Problemi comuni
Cursor continua ad aggiungere nuove stringhe hardcoded
Soluzione: globalize.now viene eseguito a ogni push su Git, così i nuovi letterali vengono rilevati automaticamente invece di accumularsi silenziosamente tra i rilasci.
Le chiavi di traduzione entrano in conflitto con una configurazione i18n esistente
Soluzione: globalize.now rileva le librerie i18n esistenti e segue le loro convenzioni così le nuove chiavi estendono il tuo catalogo attuale invece di entrare in conflitto.
Domande frequenti
globalize.now funziona con qualsiasi progetto generato da Cursor?
Sì, purché lo stack sia uno che globalize.now supporta tramite le sue skill dell'agente (framework JavaScript moderni come Next.js, React o Vue). globalize.now si concentra sull'estrazione di stringhe UI hardcoded e sulla produzione di chiavi più file di traduzione, non su quale editor ha prodotto il JSX. Esegui comunque npx globalize-skills dalla radice del progetto e segui i prompt guidati così l'agente può scansionare il repo e aprire diff mergibili.
Devo configurare globalize.now per rilevare pattern specifici di Cursor?
Non è richiesta alcuna integrazione Cursor separata. globalize.now analizza il repository nello stesso modo indipendentemente dal fatto che i file siano stati creati manualmente o da Cursor. Le skill cercano letterali visibili all'utente e struttura di routing, quindi propongono chiavi che corrispondono alla libreria i18n che adotti. Rivedi il piano in Git come qualsiasi altro cambiamento.
Posso usare globalize.now su un progetto Cursor che ha già un i18n parziale?
Sì. Lo strumento è progettato per estendere i cataloghi esistenti quando chiavi e file di traduzione sono già presenti. globalize.now rileva la libreria runtime che usi e propone aggiunte invece di scartare il lavoro precedente, così puoi finire di migrare i letterali in modo incrementale. Continua a usare i push su Git così la nuova UI rimane coperta.
Quali librerie i18n funzionano con l'output di globalize.now in un progetto Cursor?
globalize.now è agnostico rispetto alla libreria: produce chiavi strutturate e file di traduzione che si abbinano a runtime comuni come i18next, next-intl, react-intl, Lingui e vue-i18n. Il tuo progetto Cursor mantiene qualsiasi stack tu scelga; globalize.now fornisce il livello di estrazione e sincronizzazione. Le skill dell'agente aiutano a collegare il provider o il middleware che il tuo framework si aspetta.
globalize.now modifica i miei componenti generati da Cursor?
globalize.now riscrive i siti di chiamata così i letterali fluiscono attraverso la tua API i18n (ad esempio t() o componenti message) mantenendo il comportamento. Rivedi i diff in Git prima di fare il merge, proprio come qualsiasi cambiamento generato da Cursor. Dopo il primo merge, i push futuri continuano a sincronizzare automaticamente le nuove stringhe senza un passaggio di esportazione separato.
Dove eseguo globalize.now dentro Cursor?
Esegui sempre npx globalize-skills dalla radice del repository nel terminale integrato di Cursor (o in qualsiasi shell puntata a quella radice). Le skill si limitano al progetto attuale, installano il bundle di skill di localizzazione e restituiscono il controllo al tuo agente per i prompt di follow-up. Restare alla radice mantiene il rilevamento dei percorsi allineato con il modo in cui il CLI scansiona l'albero.
Prova globalize.now con Cursor
Avvia dalla root del tuo progetto:
npx globalize-skillsTorna alla homepage per il contesto del prodotto e i prezzi →