Navegación declarativa y overlays para Flutter.

Controla páginas de Navigator 2.0 y overlays locales de pantalla sin Navigator.push/pop ni showDialog.

Inicio rápido Ver en GitHub

Las páginas son datos

PageEntry solo guarda metadatos. La UI se crea con tu resolver.

Overlays locales

Diálogos y bottom sheets se acotan por pantalla sin estado global.

Independiente del estado

Usa setState, Riverpod, Bloc o Provider. No se requiere dependencia.

Primeros pasos

Instala declarative_nav y renderiza páginas con un callback de resolver.

Instalación

flutter pub add declarative_nav

Guía de uso

app_root.dart

class AppRoot extends StatefulWidget {
  const AppRoot({super.key});

  @override
  State<AppRoot> createState() => _AppRootState();
}

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

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

  Widget buildPage(BuildContext context, PageEntry page) {
    return HomePage(onOpenDialog: _openDialog);
  }

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

Nota importante

Este paquete evita Navigator.push/pop y llamadas a showDialog. Controla navegación y overlays desde el estado.

Resumen

Instalación