First Translation
Run your first Babelize translation in under 5 minutes: connect a GitHub repo, pick target languages, run the engine, and merge the localization PR.
Translate a React, Next.js, Django or static HTML project (Vue and React Native in beta) from your terminal in minutes. The dashboard workflow below does the same thing — pick whichever you prefer.
Prerequisites
- A Babelize account (sign up here)
- Node.js 22 or later
- A React, Next.js, Django or static HTML project — Vue and React Native work in beta (on GitHub, or available as a ZIP)
The CLI path
Step 1: Install and log in
npm install -g @babelize/cli
babelize auth loginStep 2: Initialize your project
cd your-app
babelize initinit prompts for a project name, repository URL, and target languages,
creates the project on Babelize, and writes .babelize/config.json in your
repo (the CLI reads the project ID and languages from it afterwards). Add
--name, --repo-url, and --languages to skip the prompts.
To create a ZIP project instead of a GitHub one, run babelize init --source zip. It zips the current directory, leaving out gitignored files,
node_modules, build output and secrets such as .env files and private
keys. Then it uploads the archive (50 MB max) the same way the dashboard's
Upload ZIP does.
Step 3: Run the translation
babelize run startThe engine clones your repository, detects the framework, extracts strings via AST analysis, translates them, and injects the locale files back into the project. Watch it live with:
babelize run status <babel-id> --watchStep 4: Raise the PR
When the run completes the CLI raises a pull request automatically (skip it
with --no-pr). You can also raise one yourself:
babelize pr raise <project-uuid>Open the PR on GitHub, review the translated resource files, and merge. Your app is now multilingual.
The dashboard path
- Create a project — click New Project, connect your GitHub repository (or upload a ZIP), name the project, and choose your target languages. Your source language is detected automatically. Optionally pick a translation provider: the default Babelize engine or a BYOK key (OpenAI, Anthropic, Gemini, Groq, OpenRouter).
- Run Babelize — click Run Babelize. The engine clones the repo, scans for translatable content, and generates translations.
- Raise the PR (GitHub projects) — click Raise PR, or run
babelize pr raise <project-uuid>from the terminal. - Merge — review the diff and merge. For ZIP projects, download the translated archive from the project page instead.
What's Next?
Last updated: 2026-10-16
Create an Account
Sign up for Babelize with GitHub (recommended), email or Google, and see what to do next once your account is ready to run its first translation.
How Babelize Works
How Babelize translates an app: workspace validation, AST string extraction, key generation, translation with glossary and code context, code injection, and the PR.