# Flutter Localization

> Standards for multi-language support using easy_localization and JSON/CSV assets.

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

---


# Localization

## **Priority: P1 (STANDARD)**

Consistent multi-language support using `easy_localization`.

## Structure

```text
assets/
└── translations/
    ├── en.json
    └── vi.json
```

## Implementation Guidelines

- **Bootstrap**: Wrap root with `EasyLocalization`. Always use `await EasyLocalization.ensureInitialized()`.
- **Format**: Default to JSON. Store in `assets/translations/`.
- **Lookup**: Use `.tr()` extension on strings.
- **Locale**: Change via `context.setLocale(Locale('code'))`.
- **Params**: Use `{}` in JSON; pass via `tr(args: [...])`.
- **Counting**: Use `plural()` for quantities.
- **Sheets**: Sync via `sheet_loader_localization` from Google Sheets for Online file storage to JSON/CSV.

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