Architecture

​

Frontend

• app/: routes, layouts, providers, API routes
• components/: shadcn-based building blocks and domain UIs
• hooks/: data access and UI state
• types/: shared domain types

​

Backend

• convex/: domain functions (queries/mutations/actions), schema, auth config
• app/api/*: Next.js API routes (webhooks, generators, integrations)
• lib/: server helpers (auth, sockets, GitHub client, webhook verification)

​

Data flow

• UI calls Convex functions via hooks
• Webhooks enter via app/api/webhooks/* and update Convex
• Schedulers trigger sync (GitHub) and write sync state

​

Providers

• Auth provider via Convex auth
• Theme and UI providers in app/layout.tsx