jac-cl-routing

Create a pages/ directory where each file with a public export returning JsxPage becomes a route by convention, such as pages/about.jac mapping to /about. Then make main.jac export def:pub app(children) that renders the children so the generated router tree displays.

File-based routing with a pages/ directory is the recommended default since routes are created by convention with no Router wiring. Manual <Router>/<Routes> is the alternative for one explicit route table, but you must pick one system and never mix them.

Place pages inside a route group folder named (auth)/ and the build automatically wraps every page inside with an AuthGuard, adding no URL segment. The default unauthenticated redirect is /login, configurable via auth_redirect in jac.toml.

The most common cause is an app export that ignores its children, such as the single-page template shape, which silently drops every route. Export def:pub app(children) returning JSX that renders children, since a JSX-less app is placed server-side and never exported to the client entry.

Use useParams() and access values by subscript like params["id"], since it returns a plain dict and dot access fails. For query strings, parse useLocation().search with new(URLSearchParams, location.search), as there is no useSearchParams hook.