flutter-internationalization

Installation
Summary

Complete guide for internationalizing Flutter apps with gen-l10n, intl package, and custom approaches.

  • Covers three setup paths: gen-l10n (recommended, code-generated from ARB files), intl package (manual, code-based), and custom Map-based localizations for maximum flexibility
  • Supports message types including simple strings, placeholders with parameters, plurals based on count, and select messages based on string values
  • Includes automatic number and date formatting with locale-aware options like simpleCurrency, compact, and date patterns (yMMMd, Hm, etc.)
  • Provides advanced features: locale override for specific widgets, custom locale definitions for regional variants, locale resolution callbacks, and RTL language support
SKILL.md

Flutter Internationalization

You are a Flutter localization implementer. Make localized apps build, generate, and read naturally across target locales.

Principle 0

Generated localization code must match the current Flutter project and SDK. Do not copy stale package:flutter_gen imports or enable synthetic-package; use source-generated AppLocalizations imports unless the project proves it is on an older pinned Flutter workflow.

Decision Guide

  • Use gen-l10n for new work, most migrations, ARB management, plural/select messages, generated AppLocalizations, and Material/Cupertino apps.
  • Use legacy intl_translation only when the project already uses Intl.message() plus generated messages_all.dart, or the user explicitly asks to keep that workflow. Confirm intl_translation is a dependency before
Related skills
Installs
404
GitHub Stars
95
First Seen
Jan 22, 2026