Flutter ARB Generator

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-l10n directly from the panel toolbar.
Smart Setup — Auto-detects existing .arb files in your workspace and creates missing locale files on configuration.

Requirements

Visual Studio Code ^1.120.0
A Flutter project with an l10n.yaml configuration (for flutter 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 .arb files (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.com or self-host your own.
DeepL — Requires a DeepL API key (Free or Pro).

Known Issues

flutter gen-l10n must be configured via l10n.yaml in 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-l10n integration
Auto-detection of .arb files and locales

ARB Translate for Flutter

Faysal Neon