maui-shell-navigation

Organize MAUI Shell navigation with routes, tabs, and GoToAsync.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Navigating complex MAUI applications with Shell can be error-prone; this Skill provides a clear blueprint for structuring AppShell, Flyout items, tabs, and routes to simplify navigation.

Core Features & Use Cases

  • Explains the four-level Shell hierarchy (Shell > FlyoutItem/TabBar > Tab > ShellContent) for predictable navigation.
  • Guides AppShell setup, route registration, and GoToAsync usage to support absolute and relative navigation, with query parameters.
  • Covers navigation events, back navigation behavior, and inspection of Shell state for robust app behavior.

Quick Start

Create a basic AppShell with FlyoutItem and Tab, register routes, and start navigating with GoToAsync.

Frequently Asked Questions about maui-shell-navigation

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

FAQPage Schema
How do I structure MAUI Shell navigation for a multi-page app?

Structure MAUI Shell navigation by organizing the four-level hierarchy of Shell, FlyoutItem, TabBar, Tab, and ShellContent to create predictable routing and manage complex navigational flows across multiple pages.

How do I pass query parameters using GoToAsync in .NET MAUI?

Pass query parameters in .NET MAUI by appending them to the route string within the GoToAsync call, enabling both absolute and relative navigation while supporting state inspection for robust app behavior.

What is the best way to register routes in a MAUI AppShell?

Register routes in a MAUI AppShell by mapping specific page types to route strings during initialization, allowing GoToAsync to resolve absolute and relative paths correctly for seamless navigation.

Does MAUI Shell navigation support back navigation and state inspection?

MAUI Shell navigation supports back navigation behavior and allows inspection of Shell state, enabling developers to manage navigation events and verify current navigational flows for robust application behavior.

Can I use Flyout and Tabs together in MAUI Shell navigation?

You can use Flyout and Tabs together within the MAUI Shell hierarchy by nesting FlyoutItem and TabBar structures, allowing flexible multi-page app layouts with predictable routing patterns.

Why does my relative route navigation fail in MAUI Shell?

Relative route navigation in MAUI Shell usually fails when routes are not properly registered or the Shell hierarchy is misconfigured, making it necessary to verify AppShell setup and route registration.