Navegação declarativa e overlays para Flutter.

Controle páginas do Navigator 2.0 e overlays locais de tela sem Navigator.push/pop ou showDialog.

Páginas são dados

PageEntry armazena apenas metadados. A UI é criada pelo seu resolver.

Overlays locais de tela

Diálogos e bottom sheets são limitados por tela sem estado global.

Agnóstico de estado

Use setState, Riverpod, Bloc ou Provider. Nenhuma dependência necessária.

Primeiros passos

Instale declarative_nav e renderize páginas com callback do resolver.

Instalação

Guia de uso

class AppRootState extends State<AppRoot> {
  OverlayRequest? _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,
    );
  }
}
Nota importante

Este pacote evita Navigator.push/pop e chamadas de showDialog. Controle navegação e overlays a partir do estado.