Add ARCHITECTURE.md describing high-level design and conventions

[Copilot]

Documents project architecture to make conventions explicit for contributors and AI tools.

Covers:

• Data flow — React → TanStack Query → Supabase (with localStorage fallback), minimal Hono worker
• State management — when to use Context vs TanStack Query vs localStorage vs component state; provider hierarchy from main.tsx
• Dual-mode storage — isSupabaseConfigured() branching for offline-first support
• API layer conventions — api/ (plain async functions) vs queries/ (useQuery/useMutation wrappers) separation
• Directory structure — what goes where across components/ui/, api/, queries/, context/, types/, lib/
• Adding new features — step-by-step: types → API client → query hooks → context → components

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Add ARCHITECTURE.md describing high-level design and conventions</issue_title>
<issue_description>Document the overall frontend and backend architecture in an ARCHITECTURE.md file:

• Describe high-level data flow (React → Supabase → Worker)
• State management principles: when to use Context, TanStack Query, or supabase-js
• API integration practices and directory/file structure conventions
• Where to put new features, components, and types

Impact: Makes project conventions explicit for both AI tools and humans, improving onboarding and code consistency.</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes Add ARCHITECTURE.md describing high-level design and conventions #81

---

💬 Send tasks to Copilot coding agent from Slack and Teams to turn conversations into code. Copilot posts an update in your thread when it's finished.

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	kikk	efadf5b	Commit Preview URL Branch Preview URL	Mar 21 2026, 11:24 PM