A Visual Studio Code extension for managing Flutter ARB (Application Resource Bundle) localization files. Provides a dedicated webview panel to view, add, edit, and auto-translate translation keys across all your locales.
Features
- ARB File Panel — A dedicated view in the VS Code panel that displays all translation keys across every locale in a sortable table.
- Add / Edit Keys — Add new translation keys or edit existing ones through a dialog. Auto-translate missing fields with one click.
- Auto-Translate — Translates source text into all target locales using Google Translate (free, no API key), LibreTranslate (self-hostable), or DeepL API.
- Delete Keys — Remove a translation key and its metadata from all locale files at once.
- Search — Quickly filter keys in the ARB panel.
- Flutter Integration — Run
flutter gen-l10ndirectly from the panel toolbar. - Smart Setup — Auto-detects existing
.arbfiles in your workspace and creates missing locale files on configuration.
Requirements
- Visual Studio Code
^1.120.0 - A Flutter project with an
l10n.yamlconfiguration (forflutter gen-l10n)
Usage
Quick Start
- Open your Flutter project in VS Code.
- Open the Flutter ARB Generator panel from the activity bar.
- Click Set ARB directory and select the folder containing your
.arbfiles (e.g.lib/l10n). - The extension auto-detects available locales and prompts you to configure them.
- Start managing translations.
Commands
| Command | Description |
|---|---|
Flutter ARB Generator: Set ARB directory |
Choose or type the path to your .arb folder |
Flutter ARB Generator: Set supported languages |
Select which locales to manage |
Flutter ARB Generator: Set source language |
Choose the source locale for auto-translate |
Flutter ARB Generator: Add translation key |
Open the add-key dialog |
Flutter ARB Generator: Search translations |
Focus the search bar in the panel |
Flutter ARB Generator: Generate Flutter localizations |
Run flutter gen-l10n |
Settings
| Setting | Default | Description |
|---|---|---|
arb-translator.directory |
"" |
Path to the folder containing .arb files |
arb-translator.current |
"en" |
Source language for translations |
arb-translator.locales |
[] |
List of supported locales |
arb-translator.translationProvider |
"google" |
Translation provider (google, libre, or deepl) |
arb-translator.libreTranslateUrl |
"https://libretranslate.com" |
Base URL for LibreTranslate |
arb-translator.deeplApiKey |
"" |
API key for DeepL (Free or Pro) |
Translation Providers
- Google — Free, no configuration required. Uses the public Google Translate API.
- LibreTranslate — Open-source. Use the public instance at
libretranslate.comor self-host your own. - DeepL — Requires a DeepL API key (Free or Pro).
Known Issues
flutter gen-l10nmust be configured vial10n.yamlin your project root for the sync command to work.- LibreTranslate public instances may have rate limits; consider self-hosting for heavy use.
Release Notes
0.0.1
Initial release:
- ARB file panel with locale overview
- Add, edit, and delete translation keys
- Auto-translate via Google, LibreTranslate, or DeepL
flutter gen-l10nintegration- Auto-detection of
.arbfiles and locales