cobalt_go_router 1.7.0

go_router bindings for Cobalt — dependency scopes whose lifetime is a navigation flow, created on entry and disposed on exit.

example/example.md

cobalt_go_router example

A scope whose lifetime is a navigation flow: it is built when the flow opens and disposed when the user leaves it. Navigating inside the flow keeps it.

import 'package:cobalt_go_router/cobalt_go_router.dart';
import 'package:go_router/go_router.dart';

// Build the router once. A new CobaltShellRoute instance is a different flow as
// far as go_router is concerned, because a shell page is keyed by identity.
final router = GoRouter(
  routes: [
    GoRoute(path: '/', builder: (context, state) => const HomeScreen()),
    CobaltShellRoute(
      name: 'order',
      // The scope is rebuilt when this changes, and only when it changes.
      identity: (state) => state.pathParameters['id'],
      scope: (state) => OrderScope(state.pathParameters['id']!),
      routes: [
        GoRoute(path: '/order/:id', builder: (context, state) => const SummaryScreen()),
        GoRoute(path: '/order/:id/pay', builder: (context, state) => const PaymentScreen()),
      ],
    ),
  ],
);

Inside the flow nothing new is needed — context.cobalt<OrderDraft>() resolves from the nearest scope, so the flow shadows the root automatically.

For tabs there are CobaltStatefulShellRoute and CobaltStatefulShellBranch; note that a branch is kept alive, not visible, so switching tabs disposes nothing. Runnable version: examples/flow_scopes.