# Flutter Localization

> Standards for multi-language support using easy_localization with CSV or JSON.

- Skill: `majiayu000/flutter-localization` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/flutter-localization`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/flutter-localization/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/flutter-localization

---


# 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/`

Both formats work identically with `easy_localization`.

## Structure

```text
# 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 use `await EasyLocalization.ensureInitialized()`.
- **Lookup**: Use `.tr()` extension on strings (e.g., `'welcome'.tr()`).
- **Locale**: Change via `context.setLocale(Locale('code'))`.
- **Params**: Use `{}` placeholders; pass via `tr(args: [...])`.
- **Counting**: Use `plural()` for quantities.
- **Sheets Sync**: Use `sheet_loader_localization` to 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 or `easy_localization` context methods.
- **Desync**: Keep keys identical across all locale files.

## Reference & Examples

For setup and Google Sheets automation:
See [references/REFERENCE.md](references/REFERENCE.md).

## Related Topics

idiomatic-flutter | widgets