maui-shell-navigation

Guide MAUI Shell navigation with route registration and query parameters.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This guidance helps developers implement robust MAUI Shell navigation, covering AppShell setup, route registration, URI-based GoToAsync navigation, parameter passing, back navigation, and navigation events to create scalable, user-friendly MAUI apps.

Core Features & Use Cases

  • Lazy page creation with ContentTemplate to avoid eager page instantiation during Shell startup.
  • Flexible data passing via IQueryAttributable and ShellNavigationQueryParameters for simple or complex parameter transport.
  • Route management and navigation events handling, including OnNavigating and OnNavigated for guardrails and telemetry.
  • Examples include structuring FlyoutItem/Tab-based navigation, absolute vs relative routes, and GoToAsync usage for deep linking and in-app navigation.

Quick Start

Structure your AppShell with FlyoutItem, Tab, and ShellContent using ContentTemplate, and register routes to enable responsive navigation.

Frequently Asked Questions about maui-shell-navigation

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

FAQPage Schema
How do I pass complex parameters during MAUI Shell navigation?

Pass complex parameters during MAUI Shell navigation by implementing IQueryAttributable or using ShellNavigationQueryParameters to transport data objects between pages securely.

What is the best way to prevent eager page instantiation in a MAUI Shell startup?

Prevent eager page instantiation during MAUI Shell startup by applying ContentTemplate within ShellContent to ensure lazy page creation until navigation occurs.

How do I register routes for deep linking with MAUI Shell GoToAsync?

Register routes for MAUI Shell deep linking by defining a well-defined route hierarchy with safety checks, enabling URI-based GoToAsync navigation for absolute and relative paths.

Can I use navigation events as guardrails in .NET MAUI Shell?

Use MAUI Shell navigation events like OnNavigating and OnNavigated to implement guardrails and telemetry, intercepting URI-based navigation before or after page transitions complete.

How do I structure FlyoutItem and Tab-based navigation in .NET MAUI?

Structure FlyoutItem and Tab-based navigation in .NET MAUI by configuring AppShell with ShellContent elements using ContentTemplate to manage route hierarchy and lazy loading.