Usare globalize.now con Next.js
Configura l'internazionalizzazione in un'app Next.js in meno di cinque minuti.
Next.js ha supporto i18n di prima classe tramite librerie come next-intl e next-i18next, ma quelle librerie si aspettano una codebase con chiavi di traduzione già in atto. globalize.now è il passaggio precedente: prende un'app Next.js piena di inglese hardcoded e produce le chiavi, i file di traduzione e i componenti refactored che next-intl (o qualsiasi libreria runtime) può servire.
Prerequisiti
- Un progetto Next.js (App Router o Pages Router)
- Un repository Git
- Node.js 18+
- Una libreria runtime i18n scelta (next-intl consigliato)
Come configurare globalize.now con Next.js
Installa la tua libreria runtime
Aggiungi next-intl o la libreria che preferisci così l'app può caricare messaggi per locale al runtime.
npm install next-intlConfigura il routing di base next-intl
Collega middleware, provider e segmenti di route come descritto nella documentazione di next-intl, oppure salta questo passaggio se l'hai già completato.
Esegui l'installer delle skill Globalize
Dalla radice del progetto Next.js, installa le skill così l'agente può allinearsi con la tua configurazione di routing.
npx globalize-skillsConferma il rilevamento di next-intl
Lascia che l'agente verifichi che i provider e i percorsi dei messaggi corrispondano alle convenzioni che globalize.now si aspetta per Next.js.
Rivedi il layout proposto del file di traduzione
Ispeziona la directory di messaggi suggerita e i nomi dei file così seguono il pattern messaggi-per-locale che hai scelto.
Refactor dei letterali in chiamate di traduzione
Approva gli aggiornamenti che sostituiscono l'inglese incorporato con helper t() o equivalenti collegati al tuo provider.
Pusha su Git
Fai il merge del branch e pusha così globalize.now può mantenere le traduzioni sincronizzate nei push su Git successivi.
Problemi comuni
next-intl si aspetta una struttura di messaggio specifica
Soluzione: globalize.now rileva automaticamente la convenzione next-intl e scrive JSON che corrisponde alle tue cartelle di locale configurate, riducendo il rimodellamento manuale.
Ho già alcune stringhe tradotte — globalize.now le sovrascriverà?
Soluzione: Le chiavi esistenti vengono preservate quando possibile e i nuovi letterali vengono aggiunti in modo incrementale così i traduttori non perdono il lavoro precedente.
Domande frequenti
globalize.now funziona con next-intl e next-i18next?
Sì. globalize.now si concentra sulla struttura del repository — chiavi, cataloghi JSON e siti di chiamata dei componenti — mentre next-intl o next-i18next continua a caricare i messaggi al runtime. Scegli quale runtime corrisponde al tuo modello di routing; globalize.now adatta il suo output a quella scelta. Esegui comunque npx globalize-skills una volta per bootstrap del progetto a meno che tu non intenda aggiornare intenzionalmente le skill.
globalize.now supporta sia App Router che Pages Router?
Sì. Le skill dell'agente rilevano lo stile di router che usi e allineano l'estrazione ai file di layout, handler di route e provider corretti. globalize.now non sostituisce il routing di Next.js; assicura che le stringhe che fluiscono attraverso quei route siano keyed. Dopo la configurazione, sia i server component che i client component di App Router fanno riferimento agli stessi file locale che il tuo runtime si aspetta.
Posso usare globalize.now con un'app Next.js che ha già un i18n parziale?
Sì. Punta l'agente al repo e estenderà i bundle di messaggi esistenti, colmando i vuoti dove rimangono letterali. È comune quando solo le pagine di marketing sono state tradotte per prime. globalize.now unisce le nuove chiavi senza scartare le traduzioni precedenti, quindi i team possono migrare schermata per schermata.
globalize.now gestisce diversamente i server component e i client component?
globalize.now riscrive i letterali a qualsiasi helper usi il tuo stack per ogni boundary, rispettando le regole di Next.js su dove hook e provider possono girare. L'output JSON rimane condiviso tra i bundle server e client così non duplichi i cataloghi. Continui a seguire la documentazione di Next.js per marcare i client component quando l'interattività lo richiede.
Come si integra globalize.now con la generazione statica di Next.js?
I file locale vivono in Git, quindi `next build` continua a bundlare lo stesso JSON che i tuoi route SSG o SSR già importano tramite next-intl. globalize.now non cambia la pipeline di generazione statica oltre ad assicurare che le stringhe provengano da file di dati invece che da letterali. Quando nuovo copy viene rilasciato, un altro push su Git aggiorna le traduzioni prima del prossimo deployment.
Devo installare next-intl prima di eseguire npx globalize-skills?
Installare next-intl per primo è ideale quando sai già che è il tuo runtime, perché l'agente può collegare i provider immediatamente. Se non hai ancora scelto una libreria, puoi comunque eseguire npx globalize-skills — le skill aiutano a consigliare uno stack — ma potresti rieseguire la configurazione dopo aver installato le dipendenze. Entrambi i percorsi terminano con le chiavi controllate in Git e sincronizzazione a ogni push.
Prova globalize.now con Next.js
Inizia dalla radice del tuo progetto:
npx globalize-skillsTorna alla homepage per il contesto del prodotto e i prezzi →