Reference

Behavioral manuals for Stario types and modules: lifecycle, invariants, who constructs what, and how pieces compose. Signatures and parameter notes come from docstrings via apidoc blocks on each page.

For walkthroughs, see Tutorials. For design rationale, see Explanation.

HTTP and runtime

• Runtime — App, bootstrap, Server, shutdown, and task drain.

• Routing — Route, app.add, app.use middleware, route parameters.

• Request and context — Context, Request, query, body, c.state.

• Responses — Writer, cookies, streaming, compression.

• Configuration — STARIO_* environment variables, ServerConfig, and RequestPolicy.

Markup and Datastar

• HTML — stario.markup trees, Attrs, baked components, SVG.

• Datastar — data / at namespaces, signals, SSE, read_signals.

• Files and assets — Assets, Files, fingerprinted href(). stario.staticassets is obsolete.

The page idea is Go-to architecture. This page is the helper contract.

Operations and utilities

• Telemetry — span handles, tracers, sinks, TelemetryStats.

• Testing — TestClient, in-process HTTP tests, drain_tasks.

• JSON — process-wide codec (stario.json, set_codec()).

• Toolbox — Relay.

• Glossary — short definitions with links into the pages above.