⬅️ Back to Frontend Architecture Index
Architecture Decision Records (ADRs)
This directory contains architecture decisions with justification.
ADRs answer: - Why we chose a design (and why not alternatives) - what tradeoffs we accept - where the decision is implemented (high-level pointers)
ADRs do not document: - how a component works internally - step-by-step implementation details
Index
- ADR-0001: Frontend folder structure strategy (App Shell + Pages + API + Cross-cutting)
- ADR-0002: API layer abstraction with shared httpClient and domain modules
- ADR-0003: Page model and domain separation (Inventory/Suppliers/Analytics)
- ADR-0004: Dialog/workflow architecture (Dialog folders + orchestration pattern)
- ADR-0005: Application shell split: authenticated shell vs public shell
- ADR-0006: Global state approach using Context modules (Auth/Settings/Toast/Help)
- ADR-0007: i18n strategy and language/region settings integration
- ADR-0008: Testing structure and taxonomy under src/tests