# Uno Navigation Qualifiers

> Use navigation qualifiers in Uno Platform to control back stack behavior.

- Skill: `unoplatform/uno-navigation-qualifiers` (Agent Skill)
- Install (CLI): `npx skillmds@latest add unoplatform/uno-navigation-qualifiers`
- Raw SKILL.md: https://api.skillmd.com/api/skills/unoplatform/uno-navigation-qualifiers/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: unoplatform (https://skillmd.com/u/unoplatform)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/unoplatform/uno-navigation-qualifiers

---


# Uno Navigation Qualifiers — Agent Skill

## Workflow

> **Docs lookup:** call `uno_platform_docs_search(...)` first, then `uno_platform_docs_fetch(sourcePath="…")` using the `sourcePath` field from a result (a relative `.md` path; add the result's `anchor` for a section). Never pass a URL, a `.html` link, or a hand-built path.

### Step 1: Fetch the Qualifiers Documentation

```
uno_platform_docs_search("Uno Navigation qualifiers back stack clear dialog Qualifiers class")
```

Primary documentation pages:
- **Navigation Qualifiers Reference**: `external/uno.extensions/doc/Reference/Navigation/Qualifiers.md`
- **Advanced Page Navigation**: `external/uno.extensions/doc/Learn/Navigation/Walkthrough/AdvancedPageNavigation.md`
- **XAML Navigation Qualifiers (Chefs)**: `external/uno.chefs/doc/navigation/XamlNavigation.md`

Fetch the qualifiers reference:

```
uno_platform_docs_fetch(sourcePath="external/uno.extensions/doc/Reference/Navigation/Qualifiers.md")
```

### Step 2: For Advanced Back Stack Management

Fetch the advanced page navigation walkthrough:

```
uno_platform_docs_fetch(sourcePath="external/uno.extensions/doc/Learn/Navigation/Walkthrough/AdvancedPageNavigation.md")
```

### Step 3: For Code-Behind Qualifiers

If using qualifiers from code:

```
uno_platform_docs_search("Uno Navigation Qualifiers.ClearBackStack code behind NavigateViewModelAsync")
```

Key page:
- **How-To Advanced Page Navigation**: `external/uno.extensions/doc/Learn/Navigation/Advanced/HowTo-AdvancedPageNavigation.md`

## Key Principles (Stable)

- `-/` prefix: clears back stack (e.g., `uen:Navigation.Request="-/Login"`)
- `!/` prefix: opens a dialog/flyout
- Qualifiers can be combined with route names
- From code: use `Qualifiers.ClearBackStack`, `Qualifiers.Dialog`, etc.
- `Qualifiers` class is in `Uno.Extensions.Navigation` namespace
- Common scenario: after login, navigate to main page with `-/` to prevent back navigation to login

## Related Skills

- [[uno-navigation-code]] — Programmatic navigation
- [[uno-navigation-xaml]] — XAML navigation with qualifiers
- [[uno-navigation-dialogs]] — Dialog navigation