Getting Started
Install i1n, initialize your project, and ship your first translation in under two minutes.
Installation
Install i1n globally via npm. This provides the i1n CLI across all your projects.
Requirements: Node.js 18 or later. Works on macOS, Linux, and Windows.
Create Your Account
Before using the CLI, create an account at dashboard.i1n.ai. You can sign up with Google or GitHub — no separate password required.
Once logged in, create an organization (or accept an invitation to join an existing one). Each organization has its own projects, team members, and billing plan.
Navigate to your organization settings to generate an API key. This key links the CLI to your organization and allows it to access your projects.
Initialize Your Project
Run i1n init in your project directory. The CLI will prompt you for your API key, then auto-detect your framework, file format, and source language. Finally, it will ask you to select a project within your organization.
This creates an i1n.config.json file (gitignored) containing your project configuration and API key. Do not commit this file to version control.
Push and Translate
Use i1n push to upload your translation keys. Add the --translate flag followed by target language codes to trigger AI translation immediately.
Translations run in parallel, processing thousands of strings in seconds. Variables are automatically protected.
Pull and Ship
Run i1n pull to download translated files and auto-generate TypeScript type definitions (i1n.d.ts).
Commit the translated files, push to your repository, and deploy. Your application is now multilingual.
npm i -g i1n
cd my-app
i1n init
i1n push --translate es,fr
i1n pull