Architecture Decision Records

ADRs capture decisions that shape the design system and are expected to outlive a single implementation change.

Accepted Decisions

• ADR 0001: Theming Model: extend Material 3 with immutable semantic tokens and CompositionLocals.
• ADR 0002: Module Boundaries: keep pure Kotlin helpers, tokens, theme contracts, icons, utilities, components, testing, catalog, and sample modules separate.
• ADR 0003: Testing Strategy: combine JVM/domain tests, Compose UI tests, and Roborazzi screenshot coverage.

Writing New ADRs

Add new records for decisions that affect public APIs, module boundaries, publishing, test strategy, or long-term compatibility. Use the next sequential number and keep each record focused on one decision.