Python Route Modules
Caspian discovers pages, nested shells, navigation loaders, and fallback
screens from focused Python modules under src/app.
Each module returns readable markup with html(...)
and keeps its owned server behavior beside that markup.
Convention map
A route needs index.py. Add the other
modules only where their behavior belongs.
index.py
Defines the route page, first-render data, metadata, RPC actions, validation, redirects, and route-owned policy.
layout.py
Wraps a route subtree with shared navigation, providers, metadata, and layout context.
loading.py
Supplies the closest loading UI while PulsePoint resolves a route navigation.
not_found.py
Renders the application fallback for unmatched URLs with the correct 404 response.
error.py
Owns the application error screen while the runtime keeps development detail and production-safe output separate.