Learning path¶

A suggested order from first page to production-minded apps. Start with Installation only if you need prerequisites; otherwise Build your first app if you have not run Hello → Refresh yet.

1. Hello page (~10 minutes)¶

Build your first app
Installation (extras / troubleshooting as needed)
Optional: Understanding maturity labels

That is the first success. Extend the same app in the next section; do not start a second project.

2. First interaction (~20–30 minutes)¶

HTMX interactions — GET refresh into a region (edit the scaffold; browser click)
Minimal form POST — CSRF-safe classic form on /notes

Then read Core concepts if you want the page/fragment model explained (optional — skip until after a working form if you prefer).

3. Interact without a SPA (next hour)¶

Mutations — @action vs @component POST
Forms and actions — validation fragments and HTMX POST
Security — CSRF profiles and headers
Optional: open /hedron-explorer/ with hedron[dev] and explorer="development"

4. Pick your host¶

If you…	Read
Stay on FastAPI	Continue with guides below
Use Flask	Add to an existing Flask app
Use Django	Add to an existing Django project
Prefer Jinja/HTML templates	HDJ authoring + `hedron[jinja]`

5. Data, charts, and live updates¶

Data applications / Charts and HTMX
Recipes first: Notes + SQLAlchemy · Session auth · File upload
Optional: Dashboards · Model demos · Jobs poll / Celery / RQ
Live interaction (FastAPI live helpers; polling Supported on every host) — examples/live-interaction covers poll, token stream, SSE ping, Job SSE, WebSocket accept, and preload. Prefer polling until you have your own ops proof for SSE/WebSocket behind proxies (see What's ready)
Release notes (current train)

6. Harden and deploy¶

7. Evaluate (optional)¶

Evaluate Hedron · What’s ready · Architecture · Enterprise diligence

8. Contribute (optional)¶

Contributing · scripts/README.md

Stuck? FAQ · Troubleshooting · How to read these docs