Documentation
Everything you need to integrate Localingos into your project.
Step 1 — Install the CLI
Install the Localingos CLI globally via npm.
npm install -g localingosStep 2 — Initialize your project
Before running this command: Create a project in the Projects page and generate an API key in Developer Tools → API Keys. You will need both during initialization.
Run init in your project root. It will ask for your API key, project ID, source locale, file format, and paths.localingos initAt the end, the CLI will ask what you want to do next:
Option A: Your project already has a source locale file (e.g.
Choose "Run sync" or skip and run
en-US.json)Choose "Run sync" or skip and run
localingos sync yourself. This pushes your source strings and pulls back translations. You are done.Option B: Your project has hardcoded strings (not yet internationalized)
Choose "Generate an AI prompt". This creates a
Choose "Generate an AI prompt". This creates a
.localingos-extract-prompt.md file with instructions for an AI coding agent (Cursor, Copilot, etc.) to extract all strings, set up the i18n framework, and create locale files automatically. Then run localingos sync to translate.Option C: No AI agent available
Follow our in the Documentation (Manual i18n Setup tab) for step-by-step instructions with full code examples.
Follow our in the Documentation (Manual i18n Setup tab) for step-by-step instructions with full code examples.
Step 3 — Sync translations
Push your source strings to Localingos and pull back translations for all target locales in one command.
localingos sync