Guida rapida: progetto e chiavi
Tutti i playground di questo sito funzionano su un progetto demo condiviso, quindi puoi esplorare senza un account. Per tradurre la tua app ti servono tre cose dalla dashboard di Langsys: un progetto, una chiave di scrittura e una chiave di sola lettura. Due minuti, una sola volta.
La configurazione
- Accedi su app.langsys.dev: crea un account se non ne hai uno.
- Crea un progetto. Scegli il locale di base (la lingua in cui sono scritte le tue frasi di origine) e i locali di destinazione per cui vuoi le traduzioni. Copia l'ID del progetto.
- Genera due chiavi API per il progetto: una chiave di scrittura e una chiave di sola lettura. La separazione è l'intero modello di sicurezza: Chiavi e ambienti ne spiega il motivo.
- Inseriscile nel tuo env e installa l'SDK per il tuo stack. Sviluppa con la chiave di scrittura, così le nuove frasi vengono registrate e tradotte automaticamente mentre lavori; rilascia con la chiave di sola lettura.
# .env.local — development (Vite-style names; adjust the prefix to your bundler)
VITE_LANGSYS_PROJECT_ID=your-project-id
VITE_LANGSYS_API_KEY=write-key # discovers + registers new phrases
# production
VITE_LANGSYS_PROJECT_ID=your-project-id
VITE_LANGSYS_API_KEY=read-only-key # only fetches — safe to ship in the browser# .env (Laravel, or your PHP app's environment)
LANGSYS_PROJECT_ID=your-project-id
LANGSYS_API_KEY=write-key # server-side, so the write key can stay —
# switch to read-only anywhere that must not
# register phrases (e.g. a public sandbox)Quale chiave va dove? Il browser riceve sempre e solo la chiave di sola lettura: può recuperare le traduzioni e nient'altro, quindi è sicura in un bundle pubblico. La chiave di scrittura registra nuove frasi, quindi va usata solo in sviluppo e sui server.
Poi scegli il tuo SDK
Ogni pagina dell'SDK inizia da Installazione e presuppone esattamente questa configurazione: ID progetto e chiave nel tuo env:
Frontend
TypeScript, React, Vue e Svelte, ciascuno con un playground interattivo.
Backend
PHP e Laravel: la pagina arriva già localizzata.
Meta-framework
Next.js, Nuxt e SvelteKit: precarica le traduzioni sul server, poi esegui l'hydration sul client.
Non conosci ancora i concetti di base? Parti da Concetti — la frase è la chiave, il rilevamento dei token e il locale store — poi torna qui.