Tutorials
End-to-end walkthroughs: one example app per tutorial, with enough context to see how pieces fit together.
Start at Hello world if you have not run a handler yet, then Getting started for the Tiles walkthrough. For task recipes and API detail, see How-tos and Reference.
Examples ladder
The stario examples teach different skills. New projects should start from the chat-room tree — see AI-assisted development.
| Step | Tutorial | Example | What you learn |
|---|---|---|---|
| 1 | Hello world | hello-world/ | Client signals, read_signals, SSE(w).patch_signals, bootstrap |
| 2 | Getting started | tiles/ | Live Tiles demo: Relay, CQRS routes, element patches (annotated source) |
| 3 | Chat room | chat-room/ | Recommended project shape: app/features/, SQLite, register_*, tests |
Run chat-room with uv run stario watch app.main:bootstrap. Single-file tutorials use main:bootstrap.
Walkthroughs
Hello world — minimal counter with Datastar signals (
examples/hello-world).Getting started — interactive Tiles walkthrough with live embed and line-numbered source.
Realtime tiles — longer narrative tour of the same Tiles example.
Chat room — multi-room chat with SQLite and feature modules (
examples/chat-room).