Pose una domanda e ottieni un riassunto del documento facendo riferimento a questa pagina e al provider AI di tua scelta
Cronologia delle versioni
- "init registra anche i plugin di lint / Prettier; aggiunto init ai; i file .content vengono ignorati nelle route TanStack"v9.8.113/11/2026
- "init installa solo i pacchetti e configura il framework; aggiunto un sottocomando per ogni passaggio; --interactive fallisce senza terminale"v9.5.1329/09/2026
- "Aggiunta del sottocomando init infra"v9.5.621/09/2026
- "Aggiunta opzione --no-gitignore"v8.6.431/03/2026
- "Aggiunto comando init"v7.5.930/12/2025
Il contenuto di questa pagina è stato tradotto con un'IA.
Vedi l'ultima versione del contenuto originale in ingleseSe hai un’idea per migliorare questa documentazione, non esitare a contribuire inviando una pull request su GitHub.
Collegamento GitHub alla documentazioneCopia il Markdown del documento nella porta-documenti
Inizializza Intlayer
Copiare il codice nella clipboard
Il comando init installa i pacchetti Intlayer e configura il tuo framework (file di configurazione, TypeScript, plugin del bundler, middleware/proxy, provider). È il modo consigliato per iniziare con Intlayer.
Tutto il resto (workflow di CI, skill IA, server MCP, strumenti dell'editor, regole di lint, CMS, infrastruttura) è facoltativo: sceglilo dalla checklist di --interactive oppure esegui il relativo sottocomando (vedi sotto).
Alias:
npx intlayer init
Argomenti:
--project-root [projectRoot]- Opzionale. Specifica la directory principale del progetto. Se non fornita, il comando cercherà la radice del progetto a partire dalla directory di lavoro corrente.--no-gitignore- Opzionale. Salta l'aggiornamento automatico del file.gitignore. Se questo flag è impostato,.intlayernon verrà aggiunto a.gitignore.--no-framework-setup- Opzionale. Installa solo i pacchetti, senza modificare i file del progetto.--no-eslint- Opzionale. Non attiva le regole di lint di Intlayer.--no-prettier- Opzionale. Non aggiunge il plugin Prettier di Intlayer.--routing <routing>- Opzionale. Routing delle lingue:prefix-no-default(predefinito),prefix-all,no-prefix,search-paramsonone.--content <layout>- Opzionale. Come viene dichiarato il contenuto:multilingual-{fileName}.content.{ts,json}accanto al componente, tutte le lingue in un unico file (impostacompiler.output).per-locale-{fileName}.{locale}.content.{ts,json}accanto al componente (impostacompiler.outputedictionary.locale).centralized- un catalogo/locales/{locale}.{json,po}per lingua (aggiunge il pluginsyncJSON/syncPO).namespaces- cataloghi/locales/{locale}/{namespace}.{json,po}(aggiunge il pluginsyncJSON/syncPO).
--content-format <format>- Opzionale, con--content.tsojsonpermultilingual/per-locale,jsonopopercentralized/namespaces. Predefinito il primo.--message-format <format>- Opzionale, con--content centralizedonamespacesin JSON. Sintassi dei messaggi dei cataloghi:icu(predefinito),i18next,vue-i18nointlayer.-i, --interactive- Opzionale. Scegli i passaggi da una checklist (pacchetti, CI, skill, MCP, VS Code, LSP, lint, CMS, infrastruttura, …) invece dell'insieme predefinito. Richiede un terminale: senza (agente IA, CI), il comando fallisce ed elenca i sottocomandi da eseguire al suo posto.--no-github-actions- Opzionale. Con--interactive, non crea mai i workflow di GitHub Actions, anche se selezionati.
Cosa fa:
Il comando init esegue le seguenti attività di configurazione:
- Valida la struttura del progetto - Si assicura che tu sia in una directory di progetto valida con un file
package.json. - Installa i pacchetti - Installa i pacchetti Intlayer mancanti per il tuo stack (ad es.
react-intlayer,vite-intlayer) e aggiorna quelli obsoleti. - Aggiorna
.gitignore- Aggiunge.intlayeral tuo file.gitignoreper escludere i file generati dal controllo di versione (può essere saltato con--no-gitignore). - Configura TypeScript - Aggiorna tutti i file
tsconfig.jsonper includere le definizioni dei tipi Intlayer (.intlayer/**/*.ts). - Crea il file di configurazione - Genera un
intlayer.config.ts(per progetti TypeScript) ointlayer.config.mjs(per progetti JavaScript) con le impostazioni predefinite. - Aggiorna la configurazione del bundler / framework - Aggiunge il plugin Intlayer alla configurazione di Vite, Next.js, Nuxt, Astro, …, e crea middleware/proxy e provider quando il framework lo supporta. Su TanStack Start / Router, imposta
routeFileIgnorePatternin modo che i file.contentinroutes/non vengano trattati come route. - Plugin di lint e formattazione - Se il progetto usa ESLint / oxlint o Prettier, installa
eslint-plugin-intlayer/prettier-plugin-intlayere li registra nella config flat di ESLint, in.oxlintrc.jsone nella config di Prettier. Una config che non può essere modificata in sicurezza riceve invece lo snippet da incollare.
Configurare un passaggio alla volta
Ogni passaggio della checklist di --interactive ha il suo sottocomando. Non fanno domande quando i valori vengono passati come flag, quindi puoi eseguirli da un agente IA o da un job di CI.
Apri la tabella in una finestra modale per visualizzare tutti i dati in modo chiaro
| Comando | Cosa configura |
|---|---|
intlayer init packages | Installa i pacchetti Intlayer mancanti e aggiorna quelli obsoleti |
intlayer init project [--routing <routing>] [--content <layout>] | File di configurazione, TypeScript, plugin del bundler, middleware/proxy, provider e .gitignore |
intlayer init github-actions | I workflow di GitHub Actions fill e test |
intlayer init vscode-extension | Consiglia l'estensione Intlayer in .vscode/extensions.json |
intlayer init lsp | Il language server di Intlayer in .vscode/settings.json |
intlayer init ai [--provider <provider>] [--model <model>] | Installa l'SDK del provider IA, elenca i suoi modelli e salva la chiave API in .env |
intlayer init eslint | Le regole di lint di Intlayer (ESLint / oxlint), se il progetto usa già un linter |
intlayer init prettier | Il plugin Prettier di Intlayer, se il progetto formatta già con Prettier |
intlayer init skills [--platform <platform>] [--skills <skills…>] | La documentazione di Intlayer come skill per agenti IA |
intlayer init mcp [--platform <platform>] [--transport <stdio/sse>] | Il server MCP di Intlayer |
intlayer init extension [--browser <chrome/firefox>] | Apre la pagina dello store dell'estensione browser di Intlayer |
intlayer init cms | Accede al CMS Intlayer tramite il browser e salva le credenziali in .env |
intlayer init infra --mode <desktop/docker/compose> | L'app desktop o uno stack self-hosted |
Da un agente IA o da un job di CI
La shell di un agente IA non ha un terminale, quindi una domanda non può ricevere risposta. Usa il comando predefinito, poi i sottocomandi di cui hai bisogno:
Copiare il codice nella clipboard
Senza terminale:
init skillsinstalla le skill adatte al tuo stack, a meno che non sia impostato--skills(ad es.--skills Usage Content React).init skillseinit mcpusano la piattaforma IA rilevata (Claude Code, Cursor, VS Code, Windsurf, …), a meno che non sia impostato--platform, e falliscono con l'elenco delle piattaforme se non ne viene rilevata nessuna.init mcpusa il trasportostdio, a meno che non sia impostato--transport.init infrarichiede--mode, einit extensionmostra solo i link dello store, a meno che non sia impostato--browser.
Il server MCP viene sempre configurato all'interno del progetto (per Claude Code, in .mcp.json).
Esempi:
Inizializzazione di base:
Copiare il codice nella clipboard
Questo inizializzerà Intlayer nella directory corrente, rilevando automaticamente la radice del progetto.
Inizializzazione con radice del progetto personalizzata:
Copiare il codice nella clipboard
Questo inizializzerà Intlayer nella directory specificata.
Inizializzazione senza aggiornare .gitignore:
Copiare il codice nella clipboard
Questo configurerà tutti i file di configurazione ma non modificherà il tuo .gitignore.
Configura l'infrastruttura (applicazione desktop o auto-hosting):
Copiare il codice nella clipboard
Scarica ed esegue il programma di installazione ospitato (https://intlayer.org/install.sh, o install.ps1 su Windows), che chiede come desideri eseguire Intlayer:
- Applicazione desktop - installa la dashboard nativa sul tuo computer, connessa a Intlayer Cloud.
- Docker all-in-one - dashboard + API + MongoDB + Redis + MinIO in un unico contenitore.
- Docker Compose - un contenitore per servizio, per un auto-hosting scalabile.
Salta il menu con --mode:
Copiare il codice nella clipboard
Lo stesso passaggio è offerto da npx intlayer init --interactive. Consulta il riferimento init infra per le impostazioni del programma di installazione e la guida all'auto-hosting per informazioni sulla configurazione di ciascuna modalità.
Esempio di output:
Copiare il codice nella clipboard
Note:
- Il comando è idempotente: puoi eseguirlo più volte in sicurezza. Salterà i passaggi già configurati.
- Se esiste già un file di configurazione, non verrà sovrascritto.
- I file di configurazione TypeScript senza un array
include(ad esempio, configurazioni in stile soluzione con riferimenti) vengono saltati. - Il comando terminerà con un errore se non viene trovato alcun
package.jsonnella radice del progetto.
