davidortinau/maui-skills/maui-localization
Claude Code and agent skill by davidortinau/maui-skills
- community
Checking that the SKILL.md file is still in the repository.
Guidance for localizing .NET MAUI apps: multi-language support via .resx resource files, culture resolution and runtime switching, RTL layout, platform language declarations (iOS/Mac Catalyst Info.plist, Windows Package.appxmanifest), and image localization strategies. USE FOR: "localization", "multi-language", "resx resource", "translate app", "RTL layout", "culture switching", "localize strings", "right-to-left", "language support MAUI", "Info.plist languages". DO NOT USE FOR: theming or visual styles (use maui-theming), accessibility labels (use maui-accessibility), or content from REST APIs (use maui-rest-api).
Install
npx vskill@latest install davidortinau/maui-skills/maui-localizationSKILL.md
.NET MAUI Localization
Common gotchas
| Issue | Fix | |
|---|---|---|
ResourceManager returns null for default culture | Set <NeutralLanguage>en-US</NeutralLanguage> in .csproj | |
| iOS ignores culture overrides | CFBundleLocalizations missing from Info.plist | |
| Windows doesn't show correct language | <Resource Language="..." /> missing from Package.appxmanifest | |
x:Static bindings don't update on language switch | x:Static is one-time — use binding approach with INotifyPropertyChanged | |
.Designer.cs not regenerating in VS Code | Add <CoreCompileDependsOn>PrepareResources;$(CoreCompileDependsOn)</CoreCompileDependsOn> and run dotnet build |
⚠️ NeutralLanguage is mandatory
Platform declarations — don't forget these
iOS / Mac Catalyst
⚠️ Without this, iOS won't offer your app's languages in system Settings:
Windows
Android
Android picks up .resx-based localization automatically. No additional manifest entries required. ✅
Runtime language switching — x:Static trap
When switching culture, set all three properties or formatting is inconsistent:
RTL layout — set FlowDirection at page level
VS Code pitfall
⚠️ .Designer.cs may not regenerate on save. Add to .csproj and run dotnet build after .resx changes:
Decision framework
| Need | Approach | |
|---|---|---|
| Static multilingual strings | .resx files with x:Static bindings | |
| Runtime language switching | LocalizationResourceManager with INotifyPropertyChanged bindings | |
| Culture-specific images | Name images banner_{culture}.png or store paths in .resx | |
| RTL support | Set FlowDirection at page level, detect with TextInfo.IsRightToLeft | |
| Date/number formatting | Set CultureInfo.CurrentCulture alongside CurrentUICulture |
Quick checklist
- [ ]
NeutralLanguageset in.csproj - [ ] Default
AppResources.resxcontains all keys - [ ] Each target language has its own
AppResources.{culture}.resx - [ ] iOS/Mac:
CFBundleLocalizationslists all supported languages - [ ] Windows:
Package.appxmanifestdeclares<Resource Language="..." /> - [ ] RTL cultures set
FlowDirectionat page/app level - [ ] Runtime switching sets all three:
CurrentUICulture,CurrentCulture,AppResources.Culture - [ ]
dotnet buildregenerates.Designer.csafter.resxchanges
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingplugins/maui-skills/skills/maui-localization/SKILL.md
Popularity
- Repository stars
- 107
- Repository forks
- 15
- 7-day trend score
- 23
Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 3 Apr 2026, 7 months ago.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/davidortinau/maui-skills/maui-localization)