skills.rest
matthiasn
matthiasnCOMMUNITY
Explore all skills by this author →
Website𝕏@matthiasnehlsenGitHub

add-flutter-docusaurus-locale

Adds and audits locales across Flutter ARB catalogs and Docusaurus manual translations.

1.2k|117|Updated Mar 16, 2016
Search Tags:#audit#translation#flutter#docusaurus#ARB#Localization#I18n
One-click install
npx skills add https://github.com/matthiasn/lotti --skill add-flutter-docusaurus-locale
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: add-flutter-docusaurus-locale
Source: https://github.com/matthiasn/lotti/tree/main/.claude/skills/add-flutter-docusaurus-locale
Command: npx skills add https://github.com/matthiasn/lotti --skill add-flutter-docusaurus-locale

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Adding a new language to a Flutter app with a Docusaurus manual touches ARB catalogs, generated localization code, native platform declarations, MDX page trees, screenshot fixtures, and tests, and missing any one surface leaves the locale incomplete.

Core Features & Use Cases

  • End-to-end locale wiring: Translates the ARB catalog, regenerates localization code, updates language selectors, native platform declarations, and Docusaurus i18n configuration.
  • Contract audit script: Runs audit_locale.py to detect missing or extra ARB keys, ICU placeholder drift, and manual page path mismatches between canonical and translated docs.
  • Use Case: When adding German to your app, use this Skill to translate the ARB catalog, mirror the full Docusaurus docs tree, regenerate screenshots for every theme and viewport, and validate parity before release.

Quick Start

Use the add-flutter-docusaurus-locale skill to add French as a fully wired locale across the Flutter app and the Docusaurus manual.

Frequently Asked Questions about add-flutter-docusaurus-locale

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new language to a Flutter app with ARB files?▼

Copy the complete key set from the canonical ARB file, translate messages while preserving ICU syntax and placeholders, then run the localization generator and catalog sorter. Never hand-edit the generated Dart files.

How do I localize a Docusaurus site into a new language?▼

Add the locale to i18n.localeConfigs with label and htmlLang, create the docs plugin translation files, and mirror every canonical .md/.mdx page path in the target locale tree. Preserve MDX imports, components, links, and code unchanged.

How do I check ARB files for missing translation keys?▼

Run the bundled audit_locale.py script with the template and target ARB paths. It reports missing or extra keys, ICU placeholder drift, and manual page mismatches, exiting nonzero when any contract violation exists.

Does adding a locale to Flutter require native platform changes?▼

Yes, generated supportedLocales does not complete native registration. You must update iOS and macOS CFBundleLocalizations, Android locale config resources, and any desktop or web language metadata the project maintains.

Why do translated Flutter strings break at runtime?▼

Breakage usually comes from altered ICU placeholder names, changed plural or select branch syntax, or translated format skeletons. The audit script detects placeholder drift by comparing metadata and message patterns against the canonical catalog.

Related Skills

Explore More Software Engineering Skills→
nextcnextc
2

flutter-l10n-harmonize

Detect redundancy, inconsistency, and tone drift across Flutter ARB localization strings.

Official
Advanced
Walrus-ComputingWalrus-Computing
20

gstack

Coordinate planning, review, browser QA, shipping, and memory in Claude Code.

Official
Advanced
gabriellpequenogabriellpequeno
8

i18n-localization

Manage translation keys and validate RTL layouts in front-end and mobile UI projects.

Community
Basic
nextcnextc
2

flutter-l10n-translate

Translate untranslated Flutter ARB keys via OpenAI ChatGPT API with parallel agents.

Official
Advanced