Simulated UI patterns (not a Hedron server)¶
These in-docs demos show layout and interaction patterns. They are browser simulations—not a running Hedron process. Authentication, CSRF, persistence, HTMX, charts, and Markdown need a real Python server.
Not a live Hedron app
Filtering, tabs, dialogs, and form updates below are client-side JavaScript only.
For CSRF, HTMX fragments, and persistence, run a runnable example
(clone and uv sync; not available from pip install hedron alone).
Run a real app first¶
Prefer this before scrolling to the simulations:
git clone https://github.com/eddiethedean/hedron.git
cd hedron
uv sync
uv run uvicorn app:app --app-dir examples/reference-app --reload
Open http://127.0.0.1:8000. Walkthrough: reference app · all runnable examples.
| App | Framework | Notes |
|---|---|---|
| reference-app | FastAPI flagship | CRUD, CSRF, charts |
| flask-reference | Flask adapter | Home + fragment |
| django-reference | Django adapter | Home + fragment |
| hdj-progressive | Optional HDJ | Prints HTML to stdout (not a web server) |
| workbench-reference | FastAPI + Workbench | Ordinary-app launcher and HedronPosit variants |
Quickstarts: FastAPI · Flask · Django · HDJ API · Live interaction.
Simulated patterns¶
Decorative preview chrome below is not a real localhost server.
Team members
Manage access to the Acme workspace.
| Member | Role | Status | |
|---|---|---|---|
| ALAda Lovelace | ada@example.com | Admin | Active |
| GHGrace Hopper | grace@example.com | Member | Active |
| ATAlan Turing | alan@example.com | Member | Active |
No team members match that filter.
Try filtering for grace, then add a member. The table updates locally and announces the
change to assistive technology.
Component Explorer¶
Hedron Explorer explains what the framework registered and why it will render a given response. Switch between the preview, declared props, and request contract below.
UserCard
Platform administrator
| Prop | Type | Required |
|---|
/components/user-card200 OKHX-Request: true
HX-Target: #team-list
Accept: text/html
Returns a fragment, applies private caching, and exposes no source path.
Run the backend examples¶
Clone the repository and start a real application:
# FastAPI reference (full demo)
uv sync
uv run uvicorn app:app --app-dir examples/reference-app
# Flask slice
uv run python examples/flask-reference/app.py
# Django slice (ASGI)
cd examples/django-reference && uv run uvicorn asgi:application --port 8000
FastAPI reference credentials: admin / secret. That server exercises strict security
headers, CSRF-protected actions, lazy HTMX resources, Python composition, scoped styles, and the
sealed asset build.