Installation
Primary path: Django specialists (templates, HTMX, Alpine). HTML is claimable for designers. React and Vue are early (0.1.x) for app builders on the same bw-* look. Then copy a finished Free page.
1. Django (production)
For Django specialists. Templates, inclusion tags and gallery pages as a package, with HTMX and Alpine-shaped behaviours. This site is the running proof.
pip install django-brickwork
INSTALLED_APPS = [
...
"brickwork",
]
TEMPLATES[0]["OPTIONS"]["context_processors"] += [
"brickwork.context_processors.theme",
]
A Django site does not npm @bwui to style itself. The wheel already vendors tokens and CSS.
2. HTML stylesheet (claimable)
For web designers and static sites. Install the CSS and JS behaviours, paste a Free Templates page into the body.
npm install @bwui/css @bwui/js
<link rel="stylesheet" href="node_modules/@bwui/css/dist/brickwork.css" />
<script defer src="node_modules/@bwui/js/dist/behaviours.js"></script>
<body data-theme="light">
<!-- paste a gallery page body -->
</body>
3. React (early)
For app builders on Vite, Next.js or React. Public scope is @bwui. Package is 0.1.x: early maturity, same bw-* contract as Django and HTML. Named page exports: Homepage, Landing, ContactForm.
npm install @bwui/react @bwui/css
import "@bwui/css";
import { Homepage } from "@bwui/react";
export default function Page() {
return <Homepage brand="Your brand" />;
}
4. Vue (early)
Vue 3 adapter on the public registry at 0.1.x with the same four-job page exports. Early maturity: not a production-equal Home hero beside Django.
npm install @bwui/vue @bwui/css
import "@bwui/css";
import { Homepage } from "@bwui/vue";
Next: open a Free finished page, copy it into your project, then recolour with a brand pack when you are ready.