Getting Started
First Translation
Run your first Babelize translation in under 5 minutes.
Translate your React or Next.js app into any language in minutes.
Prerequisites
- A Babelize account (sign up here)
- A React, Next.js, or Vue project (on GitHub)
Step 1: Create a Project
Creating a project is a simple 5-step process:
- Repository & Name: Click New Project from the dashboard. Connect your GitHub repository and give your project a name.
- Languages: Add the target languages you want to translate your application into (e.g., Spanish, French, Japanese). Your source language is automatically detected.
- Provider: Choose your translation engine. You can use the default Babelize Engine, or Bring Your Own Key (BYOK) to use providers like OpenAI, Anthropic, or Gemini.
- GitHub Bot: (Optional) Install the Babelize GitHub App to your repository so Babelize can automatically raise pull requests for you.
- Confirm: Review all the details and click Create Project.
You can also use the CLI: run babelize init to set up a project from your terminal.
Step 2: Run Babelize
- Click Run Babelize on your project page
- Babelize will:
- Clone your repository
- Scan for translatable content
- Generate translations using AI
- Run the Modular Architecture pipeline
Step 3: Raise a PR
Once the translation pipeline completes, you can raise a PR to merge the translations into your codebase:
- Click Raise PR in the dashboard
- Or use the CLI:
babelize pr raise <project-uuid> - Babelize creates a pull request on GitHub with the translated files
Step 4: Merge
- Open the PR on GitHub
- Review the translated resource files
- Merge when satisfied
That's it — your app is now multilingual.
What's Next?
Last updated: 2026-06-19
How is this guide?