Drive Navigator 2.0 from state.

declarative_nav lets you manage pages and overlays as plain state without directly calling Navigator.push/pop or showDiaskrá.

Quick Start View GitHub

Pages as Data

PageEntry does not hold Widget types. UI is constructed through your resolver callback.

Skjár-local Overlays

Diaskrás and sheets can be scoped by skjár, including tab-local state when needed.

State-management Agnostic

Works with setState, Riverpod, Bloc, Provider, or any other state layer.

Getting Started Flæði

Install the package, then move pages and overlays into explicit state.

Installation

Starter Shape

class AppRootState extends State<AppRoot> {
  OverlayBeiðni? _overlay;
  late List<PageEntry> _pages;

  @override
  void initState() {
    super.initState();
    _pages = const [PageEntry(key: 'home', name: '/home')];
  }

  Widget build(BuildContext context) {
    return DeclarativePagesNavigator(
      pages: _pages,
      buildPage: _buildPage,
      onPopTop: _popTop,
      canPopTop: () => _overlay == null,
    );
  }
}

Core Rule

Do not mix imperative push/pop and declarative List<PageEntry> for the same stack. Keeping one source of truth prevents navigation drift.

OSS

Installation