Utiliser globalize.now avec Cursor

Extrayez les chaînes et générez les fichiers de locale à partir d'applications construites avec Cursor en une seule commande.

Cursor génère une interface fonctionnelle rapidement, mais code généralement l'anglais directement dans le JSX. globalize.now extrait ces chaînes codées en dur, génère les clés de traduction et crée les fichiers de locale — transformant une application construite avec Cursor en une base de code prête pour la traduction. La configuration prend une commande et se synchronise à chaque push Git par la suite.

Prérequis

  • Un projet construit avec Cursor
  • Un dépôt Git
  • Node.js 18+
  • Toute bibliothèque JavaScript i18n installée (i18next, next-intl, et similaires), ou aucune si vous commencez de zéro

Comment configurer globalize.now avec Cursor

  1. Ouvrez votre projet Cursor et confirmez Git

    Ouvrez le dépôt dans Cursor et assurez-vous que votre base de code est commitée et poussée vers un remote Git pour que les futurs pushes puissent déclencher la synchronisation.

  2. Exécutez l'installateur de compétences à la racine du projet

    Dans un terminal à la racine du dépôt, installez les compétences de l'agent Globalize pour que votre assistant puisse scaffolder l'i18n et scanner l'arborescence.

    npx globalize-skills
  3. Laissez l'agent analyser la base de code

    Suivez les invites de l'agent pour qu'il puisse localiser les chaînes codées en dur visibles par l'utilisateur dans vos composants et routes.

  4. Examinez la structure proposée des clés de traduction

    Inspectez la structure et la dénomination suggérées des clés avant que les refactorisations ne se retrouvent dans votre branche.

  5. Confirmez l'extraction et les fichiers de locale

    Approuvez les modifications pour que les clés soient générées, les composants appellent votre API i18n au lieu de littéraux, et les fichiers de locale soient écrits dans le dépôt.

  6. Commitez et poussez

    Commitez les modifications et poussez vers votre branche par défaut pour que globalize.now puisse garder les nouvelles chaînes alignées lors des futurs pushes Git.

Problèmes courants

Cursor continue d'ajouter de nouvelles chaînes codées en dur

Résolution : globalize.now s'exécute à chaque push Git, les nouveaux littéraux sont donc détectés automatiquement au lieu de s'accumuler silencieusement entre les versions.

Les clés de traduction entrent en conflit avec une configuration i18n existante

Résolution : globalize.now détecte les bibliothèques i18n existantes et suit leurs conventions pour que les nouvelles clés étendent votre catalogue actuel au lieu de le combattre.

Questions fréquemment posées

globalize.now fonctionne-t-il avec n'importe quel projet généré par Cursor ?

Oui, tant que la stack est supportée par globalize.now via ses compétences d'agent (frameworks JavaScript modernes comme Next.js, React ou Vue). globalize.now se concentre sur l'extraction des chaînes d'interface codées en dur et la production de clés plus fichiers de locale, pas sur l'éditeur qui a produit le JSX. Vous exécutez toujours npx globalize-skills à la racine du projet et suivez les invites guidées pour que l'agent puisse scanner le dépôt et ouvrir des diffs fusionnables.

Dois-je configurer globalize.now pour détecter les motifs spécifiques à Cursor ?

Aucune intégration Cursor séparée n'est requise. globalize.now analyse le dépôt de la même manière indépendamment du fait que les fichiers aient été créés manuellement ou par Cursor. Les compétences recherchent les littéraux visibles par l'utilisateur et la structure de routage, puis proposent des clés qui correspondent à la bibliothèque i18n que vous adoptez. Vous examinez le plan dans Git comme n'importe quel autre changement.

Puis-je utiliser globalize.now sur un projet Cursor qui a déjà une i18n partielle ?

Oui. L'outil est conçu pour étendre les catalogues existants quand les clés et les fichiers de locale sont déjà présents. globalize.now détecte la bibliothèque runtime que vous utilisez et propose des ajouts au lieu de jeter le travail antérieur, pour que vous puissiez terminer la migration des littéraux progressivement. Continuez à utiliser les pushes Git pour que la nouvelle interface reste couverte.

Quelles bibliothèques i18n la sortie de globalize.now fonctionne-t-elle avec dans un projet Cursor ?

globalize.now est agnostique quant à la bibliothèque : il produit des clés structurées et des fichiers de locale qui s'associent avec des runtimes courants comme i18next, next-intl, react-intl, Lingui et vue-i18n. Votre projet Cursor conserve la stack que vous choisissez ; globalize.now fournit la couche d'extraction et de synchronisation. Les compétences d'agent aident à câbler le fournisseur ou le middleware que votre framework attend.

globalize.now modifie-t-il mes composants générés par Cursor ?

globalize.now réécrit les sites d'appel pour que les littéraux circulent via votre API i18n (par exemple t() ou des composants message) tout en préservant le comportement. Vous examinez les diffs dans Git avant de fusionner, comme n'importe quel changement généré par Cursor. Après la première fusion, les futurs pushes continuent à synchroniser les nouvelles chaînes automatiquement sans une étape d'export séparée.

Où exécute-t-on globalize.now dans Cursor ?

Exécutez toujours npx globalize-skills à la racine du dépôt dans le terminal intégré de Cursor (ou n'importe quel shell pointant vers cette racine). Les compétences se limitent au projet actuel, installent le bundle de compétences de localisation et rendent le contrôle à votre agent pour les invites de suivi. Rester à la racine garde la détection de chemin alignée avec la façon dont le CLI scanne l'arborescence.

Essayer globalize.now avec Cursor

Démarrez à partir de la racine de votre projet :

npx globalize-skills

Retour à la page d'accueil pour le contexte du produit et la tarification →

Autres intégrations

Commencer gratuitement