router-setup

Call createRouter with a document component and a urls() route tree, then export the router. The urls() callback provides DSL functions like path, layout, loader, and cache to declare named routes, and the router exposes a fetch method for handling requests.

Use the urls() callback DSL: path() defines a route, layout() wraps child routes, and loader() and loading() attach data fetching and skeletons. Routes get names for type-safe reverse() calls, and groups can be composed with include() or code-split with an async import provider.

Yes, set the basename option in createRouter and all routes, reverse() calls, Link components, redirects, and middleware patterns are automatically prefixed. Route names stay unprefixed, but the raw href() helper does not apply the basename.

Yes, export a worker fetch handler that calls router.fetch with the request, env, and ctx. For per-request caching, pass a cache function to createRouter that receives env and ctx and returns a CFCacheStore instance.

Calling notFound() in a handler or loader triggers a fallback chain: nearest notFoundBoundary in the route tree, then defaultNotFoundBoundary, then the notFound component, then a built-in heading. Loader-thrown 404 status is deterministic only when the loader is registered with ssr: false.