Instalação

Add the package, then move navigation and overlays into explicit state. Keep imperative push/pop out of the same stack.

Uma única dependência

Install with one pub command. No code generation setup is required.

API orientada ao estado

You control a List<PageEntry> and optional OverlayRequest as pure state.

Adoção incremental

Comece com um fluxo de recurso e migre tela por tela.

Instalar e inicializar

Use pub add e depois conecte o estado raiz inicial para páginas e overlay.

Comando

Estado inicial do app

import 'package:declarative_nav/declarative_nav.dart';

class _AppRootState extends State<AppRoot> {
  OverlayRequest? _overlay;
  late List<PageEntry> _pages;

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

Dentro de uma única pilha, PageEntry.key deve permanecer único porque ela se torna a identidade da página no Navigator.