Architecture decisions
The decision log — every architecture decision recorded for duxt.
A decision earns an ADR when it constrains work that comes later and its reasoning would otherwise be lost: a choice between real alternatives, a convention every part of the project has to follow, a trade-off that looks like a mistake until the reason is known. Records are append-only — a reversed decision is written as a new ADR that supersedes the old one, never as an edit to it.
| ADR | Decision | Status | Date |
|---|---|---|---|
| ADR-0001 | Build duxt as a layer carrying a module | accepted | 2026-09-06 |
| ADR-0002 | Generate the collections from one source list | accepted | 2026-09-06 |
| ADR-0003 | Decide the URL prefixes at build time | accepted | 2026-09-06 |
| ADR-0004 | Render Markdown components with MDC | accepted | 2026-09-06 |
| ADR-0005 | Ship the layer without owner-specific links | accepted | 2026-09-06 |
| ADR-0006 | Rebuild on a schedule rather than refresh at runtime | accepted | 2026-09-06 |
| ADR-0007 | Serve translations as collections of their own | accepted | 2026-09-06 |
| ADR-0008 | Build the theme on owned shadcn-vue components | accepted | 2026-09-08 |
| ADR-0009 | Take the SEO stack from the Nuxt SEO bundle | accepted | 2026-09-08 |
Was this page helpful?