maui-localization

Configure culture resolution and resource management for .NET MAUI apps.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/snailb1007/snail-codex-skills --skill maui-localization-snailb1007
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maui-localization
Source: https://github.com/snailb1007/snail-codex-skills/tree/main/skills/maui-localization
Command: npx skills add https://github.com/snailb1007/snail-codex-skills --skill maui-localization-snailb1007

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Localizing .NET MAUI apps can be error-prone across platforms due to inconsistent culture resolution, missing neutral language declarations, and platform-specific localization declarations. This guide provides structured practices to implement robust multilingual support, ensuring consistent behavior for end users.

Core Features & Use Cases

  • NeutralLanguage and resource management: Always declare a neutral language in the .csproj and organize AppResources.resx files per culture.
  • Platform declarations: Add CFBundleLocalizations for iOS/Mac Catalyst and Resource entries in Windows Package.appxmanifest to expose supported languages to the system.
  • Runtime language switching: Coordinate CultureInfo.CurrentUICulture, CultureInfo.CurrentCulture, and AppResources.Culture for seamless dynamic language changes.
  • RTL and layout: Apply FlowDirection at page or app level to support right-to-left languages across screens.
  • Image localization and VS Code pitfalls: Use culture-specific images or resources and ensure designer-generated code regenerates after resx changes.

Quick Start

Set NeutralLanguage in your MAUI project file, declare supported languages in platform manifests, and enable runtime culture switching in your app resources.

Frequently Asked Questions about maui-localization

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

FAQPage Schema
How do I handle .NET MAUI localization across iOS, Windows, and Android?

.NET MAUI localization requires declaring a neutral language in your .csproj and organizing AppResources.resx files per culture. You must also add platform-specific manifest declarations like CFBundleLocalizations for iOS and Resource entries in the Windows Package.appxmanifest.

How do I switch the runtime language dynamically in a .NET MAUI app?

Runtime language switching in a .NET MAUI app requires coordinating CultureInfo.CurrentUICulture, CultureInfo.CurrentCulture, and AppResources.Culture. Updating these together ensures seamless dynamic language changes across the application interface.

What do I need to declare supported languages for MAUI iOS and Mac Catalyst?

For MAUI iOS and Mac Catalyst, you must add CFBundleLocalizations to the platform manifest to expose supported languages to the system. This ensures the operating system recognizes and properly applies your localized resources.

How do I implement RTL layout for right-to-left languages in .NET MAUI?

To implement RTL layout in .NET MAUI, apply FlowDirection at the page or app level. This ensures your screens correctly support right-to-left languages across all platforms.

Why are my MAUI localized images or resx resources not updating correctly?

MAUI resx resources may not update if designer-generated code fails to regenerate after changes. Ensure culture-specific images and resources are properly configured and that Visual Studio regenerates the designer code.

Do I need a neutral language declaration for .NET MAUI resource management?

Yes, you must always declare a neutral language in the .csproj file for .NET MAUI resource management. This establishes the fallback culture and ensures AppResources.resx files are organized correctly per culture.