add-l10n-string

name: add-l10n-string description: Adds localization strings to AskmeHUMG ARB files and regenerates localizations. Use when a widget needs a new user-facing string, when hardcoded text is found in a widget, when adding new screen strings, or when the user says "add l10n", "add translation", "add string to ARB", "hardcoded text". Always run after adding new screens or features.

Add l10n String (AskmeHUMG)

3 ARB files — always update all 3

lib/l10n/app_en.arb   ← English (source of truth)
lib/l10n/app_vi.arb   ← Vietnamese
lib/l10n/app_ja.arb   ← Japanese

Key naming convention

{screen}_{element}_{state?}

Examples:
  profileShareLink
  inboxTabUnanswered
  questionSubmitErrorTooLong
  feedEmpty
  answerPublishSuccess
  adminActionRemove

MANDATORY: Every key must have an `@` metadata block

Every key in every ARB file requires a @key block with a description. No exceptions.

"feedEmpty": "No posts yet. Be the first!",
"@feedEmpty": { "description": "Empty state message on feed screen" },

This is required by the flutter gen-l10n tool for code documentation and prevents silent drift between files.

Simple string

// app_en.arb
"myNewKey": "My text here",
"@myNewKey": { "description": "Short description of where/when this string appears" },

// app_vi.arb
"myNewKey": "Văn bản của tôi",
"@myNewKey": { "description": "Mô tả ngắn bằng tiếng Việt" },

// app_ja.arb
"myNewKey": "テキスト",
"@myNewKey": { "description": "日本語での説明" },

String with placeholder

// app_en.arb
"questionCharCount": "{current}/300",
"@questionCharCount": {
  "description": "Character counter for question input",
  "placeholders": { "current": { "type": "int" } }
},

// app_vi.arb — same structure, translated value
"questionCharCount": "{current}/300",
"@questionCharCount": {
  "description": "Đếm ký tự input câu hỏi",
  "placeholders": { "current": { "type": "int" } }
},

// app_ja.arb
"questionCharCount": "{current}/300",
"@questionCharCount": {
  "description": "質問入力の文字カウンター",
  "placeholders": { "current": { "type": "int" } }
},

@ metadata block with description AND placeholders must be present in EVERY ARB file that has placeholders.

Using in widget

// Import
import 'package:askme_humg/l10n/app_localizations.dart';

// In build()
final l10n = AppLocalizations.of(context);

// Simple
Text(l10n.feedEmpty)

// With placeholder
Text(l10n.questionCharCount(currentLength))

Shortcut: context.l10n.* works if context_ext.dart extension exists.

After editing ARB files — MUST run

flutter gen-l10n

This regenerates lib/l10n/app_localizations*.dart. Never edit generated files.

Checklist

Key added to all 3 ARB files (en + vi + ja)
@key metadata block with description added in every ARB file
placeholders included in @ block if the string has {param}
Key name follows {screen}_{element} convention
flutter gen-l10n run with exit code 0
Widget uses l10n.keyName (no hardcoded string)
flutter analyze passes — no undefined l10n references

Existing keys (do not duplicate)

Common keys already in ARB: commonRetry, commonCancel, commonConfirm, commonSave, commonDelete, commonShare, commonLoading, commonEmpty, commonError.

Check lib/l10n/app_en.arb before adding — key may already exist.