Skip to main content

​
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