Flutter localization
Skill ComeOnOliver/skillshub/skills/HoangNguyen0403/agent-skills-standard/flutter-localization
Standards for multi-language support using easy_localization with CSV or JSON. Use when adding localization or multi-language support to Flutter apps. (triggers: **/assets/translations/*.json, **/assets/langs/*.csv, main.dart, localization, multi-language, translation, tr(), easy_localization, sheet_loader)From its SKILL.md
npx -y skills add ComeOnOliver/skillshub --skill flutter-localizationAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
SKILL.md
1.9 KB, 384 tokens by cl100k_base, as published. Nobody here has run it
Localization
Priority: P1 (STANDARD)
Consistent multi-language support using easy_localization.
Format Selection
- CSV (Recommended for teams with translators):
- Non-technical editors can update easily
- Native Google Sheets compatibility via
sheet_loader_localization - Store in
assets/langs/(common convention)
- JSON (Developer-friendly):
- Nested structure support (e.g.,
items_count.zero) - IDE validation and autocomplete
- Store in
assets/translations/
- Nested structure support (e.g.,
Both formats work identically with easy_localization.
Structure
# CSV Format (Google Sheets workflow)
assets/langs/langs.csv
# OR JSON Format (nested keys)
assets/translations/
├── en.json
└── vi.json
Implementation Guidelines
- Bootstrap: Wrap root with
EasyLocalization. Always useawait EasyLocalization.ensureInitialized(). - Lookup: Use
.tr()extension on strings (e.g.,'welcome'.tr()). - Locale: Change via
context.setLocale(Locale('code')). - Params: Use
{}placeholders; pass viatr(args: [...]). - Counting: Use
plural()for quantities. - Sheets Sync: Use
sheet_loader_localizationto auto-generate CSV/JSON from Google Sheets.
Anti-Patterns
- Hardcoding: No raw strings in UI; use keys.
- Manual L10n: Avoid standard
Localizations.of; use GetX oreasy_localizationcontext methods. - Desync: Keep keys identical across all locale files.
Reference & Examples
For setup and Google Sheets automation: See references/REFERENCE.md.
Related Topics
idiomatic-flutter | widgets
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.