Every URL.
A place to go.
Give every screen an address.
See how a link becomes a journey.
2026 field guide / go_router 18.1.1
Original English + 日本語 preserved.
02 / Under the route
A link, unpacked.
Change the address or a station above. Watch the path, parameters and destination change together.
/ HomeScreen
/books BookListScreen
:bookId BookScreen
/settings SettingsScreen
/sign-in SignInScreen
An illustrative JavaScript URL matcher. No Dart is executed. Your entries stay in this browser.
THE LIBRARY
Book 42
A screen with a shareable address.
A visual teaching model, not a running Flutter app. Understand the parameters ↗
03 / Choose a line
Find your way
through navigation.
One focused question at a time. Routes connect the concepts, examples and their original editions.
Your first route
Connect a URL to a screen, then prove that the same destination works after a reload.
02go, push, and the way back
Use go for a destination described by your route tree; use push when you deliberately want another page on the current stack.
03Make the URL carry the right state
Read required identifiers from pathParameters and optional filters from state.uri.queryParameters.
04Redirect without losing the destination
Return a replacement location when a routing condition requires it; return null when navigation may proceed.
05Give every tab its own journey
Use StatefulShellRoute when parallel destinations need independent navigation histories and retained branch state.
06One destination, several entry points
A working web route and a verified Android or iOS app link are separate parts of the same user journey.
04 / From the first stop
Small route.
Real direction.
The URL is a useful contract: a destination should still make sense after a reload, a deep link or a fresh start.
Read the route tree ↗final router = GoRouter(
routes: [
GoRoute(path: '/', builder: (_, __) => const HomeScreen()),
GoRoute(
path: '/books/:bookId',
builder: (_, state) => BookScreen(
id: state.pathParameters['bookId']!,
),
),
],
);
MaterialApp.router(routerConfig: router);↘ 2022EN / 日本語
GUIDES · CODE · RECORDINGS
05 / Keep the original map
Old routes.
Still worth exploring.
The original guides, example source and recordings live in their own edition. Read the early ideas, then take the current route forward.
227 source files recovered · 58 documentation and illustration files