BabelizeBabelize
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:

  1. Repository & Name: Click New Project from the dashboard. Connect your GitHub repository and give your project a name.
  2. Languages: Add the target languages you want to translate your application into (e.g., Spanish, French, Japanese). Your source language is automatically detected.
  3. 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.
  4. GitHub Bot: (Optional) Install the Babelize GitHub App to your repository so Babelize can automatically raise pull requests for you.
  5. 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

  1. Click Run Babelize on your project page
  2. 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:

  1. Click Raise PR in the dashboard
  2. Or use the CLI: babelize pr raise <project-uuid>
  3. Babelize creates a pull request on GitHub with the translated files

Step 4: Merge

  1. Open the PR on GitHub
  2. Review the translated resource files
  3. Merge when satisfied

That's it — your app is now multilingual.

What's Next?

Last updated: 2026-06-19

How is this guide?

On this page