maui-localization

Localize .NET MAUI apps using .resx resources and runtime culture switching.

Updated Nov 5, 2025
One-click install
npx skills add https://github.com/mkazimoto/AppMAUICopilot --skill maui-localization
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maui-localization
Source: https://github.com/mkazimoto/AppMAUICopilot/tree/main/.github/skills/maui-localization
Command: npx skills add https://github.com/mkazimoto/AppMAUICopilot --skill maui-localization

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Streamline the development of multilingual .NET MAUI apps by guiding the setup and usage of standard .resx resources, culture resolution, and runtime language switching to deliver localized user interfaces across platforms.

Core Features & Use Cases

  • Resource files (.resx) with conventional naming (AppResources.resx for default, AppResources.{culture}.resx for specific cultures)
  • Culture resolution order that falls back to neutral or default resources
  • XAML usage and runtime switching to apply localization without app restart
  • Platform declarations for iOS, Android, Windows, and Mac Catalyst to expose supported languages
  • Right-to-left (RTL) layout support for RTL languages
  • Image localization strategies to vary assets by culture
  • VS Code and project setup guidance for resource generation and tooling

Quick Start

Create a neutral AppResources.resx, add culture-specific AppResources.{culture}.resx files, configure NeutralLanguage in the project, and reference AppResources in your UI.

Frequently Asked Questions about maui-localization

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

FAQPage Schema
How do I localize a .NET MAUI app with .resx files?

To localize a .NET MAUI app, create a neutral AppResources.resx file, add culture-specific AppResources.{culture}.resx files, and configure NeutralLanguage in your project. Reference the generated AppResources accessors in your UI to display translated text across platforms.

Can I switch the language at runtime in a MAUI app without restarting?

Yes, you can switch the culture at runtime in a MAUI app without a restart. The localization pattern supports updating XAML bindings dynamically, allowing the user interface to reflect the newly selected language immediately after applying the culture change.

Does .NET MAUI localization support right-to-left (RTL) languages and platforms?

Yes, .NET MAUI localization supports right-to-left (RTL) layout for RTL languages. It also includes platform declarations for iOS, Android, Windows, and Mac Catalyst to properly expose supported languages to each operating system.

What is the culture resolution order when a specific translation is missing in a MAUI app?

The culture resolution order falls back to neutral or default resources when a specific translation is missing. If a requested culture-specific AppResources file lacks a key, the system automatically resolves the value from the neutral AppResources.resx file.

How do I localize images in a .NET MAUI application?

You can localize images in a .NET MAUI application by applying image localization strategies that vary assets by culture. This involves organizing your image resources to match the culture resolution order, ensuring the correct localized images load for each language.

Do I need VS Code to set up resource generation for MAUI localization?

No, but VS Code provides project setup guidance for resource generation and tooling. You need to configure your project to generate resource accessors from the AppResources.resx files, which can be done through standard .NET project configurations.