Pronto Documentation
Get your project fully localized in minutes. This guide assumes you have Node.js 18+ installed.
Quick Start
1. Install the Pronto CLI globally:
$ npm install -g pronto-cli
2. Authenticate with your Pronto account:
$ pronto login
Opening browser to authenticate...
✓ Logged in as you@example.com
Opening browser to authenticate...
✓ Logged in as you@example.com
3. Run pronto init from your project root:
$ cd my-project && pronto init
Detecting framework... Next.js
Scanning for translatable strings...
✓ 847 strings discovered across 23 files
Config written to pronto.config.json
Detecting framework... Next.js
Scanning for translatable strings...
✓ 847 strings discovered across 23 files
Config written to pronto.config.json
4. Translate to your target languages:
$ pronto translate --target es,ja
847 strings · estimated cost $0.67
Proceed? (y/n) y
✓ Done in 4.2s. 2 files written.
847 strings · estimated cost $0.67
Proceed? (y/n) y
✓ Done in 4.2s. 2 files written.
5. Commit and ship:
$ git add . && git commit -m 'chore: localize'
Explore the docs
Configuration
After running pronto init, a pronto.config.json file is created at your project root.
// pronto.config.json
{
"framework": "nextjs",
"localesDir": "./public/locales",
"sourceLocale": "en",
"targetLocales": ["es", "ja"]
}
{
"framework": "nextjs",
"localesDir": "./public/locales",
"sourceLocale": "en",
"targetLocales": ["es", "ja"]
}
GitHub Actions
Auto-localize on every push to main.
# .github/workflows/localize.yml
name: Localize
on:
push:
branches: [main]
jobs:
localize:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: npm install -g pronto-cli
- run: pronto translate --auto-approve
env:
PRONTO_TOKEN: ${{ secrets.PRONTO_TOKEN }}
name: Localize
on:
push:
branches: [main]
jobs:
localize:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: npm install -g pronto-cli
- run: pronto translate --auto-approve
env:
PRONTO_TOKEN: ${{ secrets.PRONTO_TOKEN }}