Learn Hedron

Goal (often ~5–10 minutes after Python + uv/pip are ready): Hello + click Refresh status. Ignore Beta/Supported labels until that works. Then: HTMX second region → /notes form → pick one recipe (auth or SQLite).

Path

1. Build your first app — scaffold → Hello → Refresh → edit
2. Installation — extras, Flask/Django, common problems (as needed)
3. Core concepts (optional) · Maturity labels
4. HTMX interactions — extend the Refresh pattern
5. Minimal form — CSRF-safe POST
6. Learning path — continue toward data, auth, and deploy

Help: FAQ · Troubleshooting. Optional packages (data, charts, Explorer, …): Package catalog.

Evaluating production use later? What’s ready · Why Hedron · Evaluate Hedron.

01 1. First app

Scaffold, Hello, Refresh click, then edit a string.

02 2. Installation

Extras, adapters, and troubleshooting after Hello.

03 3. HTMX

Extend the scaffold Refresh pattern with more regions.

04 4. Minimal form

CSRF-safe POST with a typed action.

05 5. Learning path

Data, auth, deploy, and optional evaluator reading.

06 Second hour — recipes

Notes + SQLAlchemy, session auth, upload, jobs poll.

Other hosts

• Flask — hedron new --flask then hedron-flask (no FastAPI)
• Django — hedron new --django then hedron-django (Django >=5.2,<6)
• Plain FastAPI — mount Hedron beside an existing FastAPI app

FastAPI remains the default hedron new path. Codespaces: Try with Codespaces.