Explanation
Why Stario is shaped the way it is: mental models, architecture patterns, and boundaries—not step-by-step tasks.
For hands-on paths, see Tutorials and How-tos. For API contracts, see Reference.
Essays
The Stario way — the overarching idea: teach the internals, not a private interpretation.
Handlers and the writer — why the handler is
async def handler(c, w), whyContextandWriterare separate, and how one signature covers three kinds of work.Go-to architecture — one subscribe stream, short commands, and
ui = f(state).Telemetry design — close the development loop: observe real traffic, then choose where those traces land.
Start here by goal
| Goal | Read |
|---|---|
| First runnable app | Hello world |
| Live UI with SSE | Go-to architecture → Realtime tiles |
| v4 routes and assets | Routing (Route) and Files and assets (await attach(app)) |
| Stario + Datastar | Datastar SDK |