Architecture and design decisions for Itemdeck.
- adrs/ - Architecture Decision Records
This directory captures why we made technical choices:
- Library selections
- Architectural patterns
- Trade-offs considered
- Alternatives rejected
| ADR | Decision | Status |
|---|---|---|
| ADR-001 | Use Framer Motion | Accepted |
| ADR-002 | Use Zod | Accepted |
| ADR-003 | Use TanStack Query | Accepted |
| ADR-004 | Use Zustand | Accepted |
| ADR-005 | Use CSS Custom Properties | Accepted |
| ADR-006 | Use TanStack Virtual | Accepted |
| ADR-007 | Use Vitest + RTL | Accepted |
| ADR-008 | Use Playwright | Accepted |
| ADR-009 | CSP + DOMPurify | Accepted |
| ADR-010 | Compound Components | Accepted |
| ADR-011 | WCAG 2.2 AA | Accepted |
| ADR-012 | Wikimedia Commons | Accepted |
| ADR-013 | External Data Repository | Accepted |
| ADR-014 | Overlay Store for Entity Edits | Accepted |
| ADR-015 | Modal Edit Form Pattern | Accepted |
| ADR-016 | Registry + Factory for Mechanics | Accepted |
| ADR-017 | Scoped Zustand Stores | Accepted |
| ADR-018 | Slot Props for Overlays | Accepted |
| ADR-019 | Configuration-First Mechanics | Accepted |