This directory contains the Architecture Decision Records (ADRs) for the Grain iOS app. ADRs document significant technical decisions, the context that drove them, and the trade-offs accepted.
Each ADR uses the lightweight format:
- Status: Proposed / Accepted / Deprecated / Superseded
- Context: What situation or problem prompted this decision
- Decision: What was decided
- Consequences: What becomes easier or harder as a result
| ADR | Title | Status | Date |
|---|---|---|---|
| ADR-0001 | Use SwiftUI + SwiftData as the app framework | Accepted | 2025 |
| ADR-0002 | Use Apple Vision framework for on-device OCR | Accepted | 2025 |
| ADR-0003 | Zero external dependencies — Apple frameworks only | Accepted | 2025 |
| ADR-0004 | Use Swift Charts for analytics visualization | Accepted | 2025 |
| ADR-0005 | Local-only storage; defer CloudKit sync | Accepted | 2025 |
| ADR-0006 | Add launch experience to mask cold start | Proposed | 2026-03-23 |
- Copy
ADR-0000-template.md(if present) or use the format above. - Number sequentially (next:
ADR-0007-...). - Add a row to the index table in this file.
- Open a PR; the ADR is merged when the decision is confirmed.