Material Navigator

MaterialNavigator is a Material Design 3-flavored subclass of Navigator. It is automatically configured by App.

The only difference from the base Navigator is the default transition: when you push a plain Widget, MaterialNavigator wraps it in a Route pre-configured with the MD3 page transition. Pushing an explicit Route bypasses this default and uses whatever transition_spec you provide.

Import convention

App and Navigator are the public names exported from nuiitivet.material for these classes. Import and use them by these names throughout your code.

from nuiitivet.material import App       # MaterialApp
from nuiitivet.material import Navigator # MaterialNavigator

The rest of this guide follows this convention.

Automatic Setup

Passing a plain Widget to App is all that is needed. App wraps it in a MaterialNavigator automatically.

from nuiitivet.material import App

App(HomeScreen()).run()

Accessing

App registers the MaterialNavigator as the root navigator.

from nuiitivet.material import Navigator

Navigator.root()    # root navigator, accessible from anywhere
Navigator.of(self)  # nearest ancestor Navigator — use only with nested navigators

Further Reading

Topic	Guide
push / pop basics	Navigation Overview
Custom transitions	Route and Animations
Intent-based routing	Intent-Based Navigation
Nested navigation	Nested Navigation

---

API Reference