Skip to content

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.

Workspace

Team members

Manage access to the Acme workspace.

Members32 active today
Administrators1Full workspace access
Pending invites0All caught up

People

Roles and contact details

MemberEmailRoleStatus
ALAda Lovelaceada@example.comAdminActive
GHGrace Hoppergrace@example.comMemberActive
ATAlan Turingalan@example.comMemberActive
New teammate

Add a member

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.

hedron-reference

UserCard

Beta
AL
Ada Lovelace

Platform administrator

Active
Render modeFRAGMENT
HTML nodes6
Diagnostics0

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.

Reference app walkthrough Build your first app