Skip to main content

django-brickwork: an open-source UI substrate for Django

A brand-agnostic, app-facing UI substrate for server-rendered Django. Tailwind 4, Alpine 3, HTMX 2, WCAG 2.2 AA as a tested guarantee, not a claim.

WCAG 2.2 AA tested MIT licensed 1.0.0rc1

Every region on this page, the sidebar, the topbar, the theme switcher above, the page header, is a real brickwork component, not a mock-up. Toggle the switcher and watch the whole shell recolour live: that is the "beautiful by default" claim, proven, not asserted.

Install

pip install django-brickwork
Browse the component gallery Browse the page templates Full package: install, docs, changelog
Public API contracts 5
Interaction components 13 increased shipped in 1.0.0rc1
Theme axes 4 unchanged theme x density x direction x brand

What brickwork provides

  • An application shell: sidebar, topbar, breadcrumbs, mobile drawer, all with a working no-JS floor.
  • Declarative navigation with permission and feature gating, resolved against the active route server-side.
  • An accessible form-field renderer and a whole-form layout tag, with a worked HTMX 422 validation loop.
  • A beautiful-by-default token system: elevation, state overlays, motion and colour derived from a small load-bearing brand set.
  • An interaction set behind stable Django components: modal, slide-over, toast, dropdown, combobox, tabs, tooltip.