AspectAvy Next — Start Here

Use When

- apps/ios/AspectAvy - apps/backend

Repo type: monorepo
Main apps:
iOS stack: SwiftUI, TCA, SQLiteData, XcodeGen, MapboxMaps
Backend stack: Fastify, TypeScript, Postgres, Docker Compose
Current phase: core product pillars are working; the repo is in stabilization, polish, and production-hardening mode
Recently surfaced milestone work now includes pinned-zone quick briefing/preferences and route-plan trip safety workspace flows, so future chats should treat those as real product surfaces rather than roadmap-only ideas
Route presentation is no longer fixed-color: user routes now carry a backend-owned presentation token, route drafting exposes color selection, and popular routes render richer cartography from normalized backend metadata plus imported map assets
Account and settings are now split, and user-facing map/layer preferences persist through a backend-backed user settings contract
Route details now follow the large-detent sheet pattern; older backlog text that still says full-screen is stale
Shared App Group, widget-extension, and field Live Activity foundations exist, but there is still no watch target and no full home-screen widget surface yet
Immediate engineering focus: use the canonical V1 milestone plan to drive the next implementation slices, while leaving manual QA to the final release-gate milestone when the user returns

- read llm/playbooks/local-setup-and-validation.md

- read llm/playbooks/implement-follow-up-slices.md

- read llm/capabilities/repo-map.md

- read llm/capabilities/current-state.md

documentation/reference/current-state.md for what works now
documentation/development/v1-remaining-milestones.md for the canonical remaining V1 execution order
documentation/development/handoff-next-chat.md for the best short handoff on near-term cleanup priorities and Apple-only surfaces
documentation/development/follow-up-backlog.md for detailed implementation and discussion items
documentation/development/program-implementation-roadmap-spec.md for the larger milestone detail across backend, iOS, parity surfaces, and on-device Foundation work
documentation/development/manual-validation-remaining.md for remaining validation
documentation/development/manual-validation-checklist.md for the current step-by-step testing order
apps/ios/AspectAvy/docs/testing-and-schemes.md for the current iOS schemes, environment configs, test plans, and CI/Xcode Cloud preparation
the current stabilization slice covers generated iOS test bundles, test plans, Xcode Cloud scaffolding, SQLiteData-friendly service tests, and the new navigation-driven developer tools dashboard with signed-in and logged-out entrypoints
README.md and documentation/README.md for repo-level orientation
if older backlog text disagrees with current-state or handoff on route-details presentation or Apple-native surfaces, prefer current-state plus handoff