Replace the Zola-based documentation site with a complete Astro rebuild.
Website:
- Full Astro + Tailwind CSS site with dark mode support
- Landing page with prose content sections and construction banner
- Responsive sidebar navigation with search (FlexSearch)
- Pattern demo system using service workers for client-side routing
- Morph-based page transitions via htmx
Content:
- Complete docs section (get started, core concepts, features, extensions, troubleshooting)
- Full reference section (attributes, events, headers, config, methods)
- Pattern examples (loading, forms, records, display, advanced)
- Extension docs for all core extensions plus download, ptag, targets
- Extension migration guide (htmx 2.x to 4.x)
- Migration guide (htmx 2.x to 4.x)
- Essays, interviews, and podcasts ported from old site
Infrastructure:
- Astro content collections for docs, reference, patterns, essays, team
- Playwright e2e tests (smoke, search, demos, patterns)
- Netlify deployment config
- npm run site / npm run www shortcuts
- /discord redirect to htmx.org/discord
- Redirect map for all old site URLs
The website used to host every past test suite, copied into the www
directory. We no longer need that on the website (and it makes the
codebase impossible to search) so I removed all the old tests and the
new tests are hosted simply at /test.
I also replaced the www.js script with a simpler www.sh one (since we no
longer need to do anything besides copying, really), which allowed me to
remove a node dependency that was only used in that script.
