Guides

Release context

Guides describe the published 1.1 release. See Current release and support for PyPI pins, the migration baseline, package maturity, and support status.

Task-oriented guidance from a working page to a maintainable Hedron project.

Complete Start first (Learning path: First app → HTMX → Minimal form). This section continues with polling, data, security, and ops.

Help: FAQ · Troubleshooting. Evaluating adoption? What’s ready · Evaluate. Shipping? Ship.

Find the shortest answer

If you need…	Use
One pasteable pattern	Cookbook
A fix organized by symptom	Troubleshooting
The meaning and remediation for HED-*	Error codes
An exact component prop or example	Component reference
An exact public API signature	API reference

Build interactions

• HTMX interactions — add a second refreshable view
• Post a minimal form — golden-path @app.action + CSRF
• Forms and actions — advanced region / InteractionResult path
• Mutations — canonical @app.action mutation routes
• Live updates (polling) — Poll is Supported; SSE/WS experimental
• HTMX extensions — declared SSE, head-support, preload

Style an interface

• Comprehensive styling — visual tour of presentation tokens, layout, themes, recipes, scoped CSS, and styling checks
• Modern CSS — application styling boundary, production checklist, progressive CSS tiers, overlays, media, controls, and fallbacks

Add data and visuals

• Data applications
• Charts and HTMX
• Maps
• Dashboards
• Compose built-ins

Secure an app

• Authentication
• OIDC
• Security
• Threat model
• Hardened sessions
• Multi-tenant isolation
• Accessibility

Operate an app

• Ship an app
• Deployment
• Secrets and workers
• Durable jobs
• Test your UI
• Performance
• Observability
• Best practices

Extend Hedron

• Use plugins
• Author plugins
• Curated extras

Other

• Migrate from Streamlit
• FAQ