How kumaraswini-11/monorepo-starter-kit works
This is a fullstack monorepo starter, not a single end-user product: its clearest runtime journey is the presentational auth UI, alongside an independently configured Better Auth backend and shared data/email infrastructure. The README explicitly says the UI is not yet wired to the backend; the graph therefore shows the API mount and backend internals separately rather than inventing a UI-to-auth flow. Major dashboard, theming, shared UI, and notification capabilities are retained. Edges are limited to excerpted calls and explicit README documentation; unsampled settings, notification, and broader auth-flow links are not inferred.
Main entry points: auth.ts Better Auth server · app Web app routes · app-shell App shell · page.tsx Dashboard
Components 20
Web experience
- Web app routes
apps/web/app - Auth entry
apps/web/app/auth/page.tsx - Auth screens
apps/web/features/auth/components - Dashboard
apps/web/app/(app)/dashboard/page.tsx - App shell
apps/web/components/app-shell - Theme controls
apps/web/components/theme - Notifications
apps/web/features/notifications/components/notification-bell.tsx
Authentication
- Auth API mount
apps/web/app/api/auth/[...all]/route.ts - Better Auth server
packages/auth/src/auth.ts - Browser auth client
packages/auth/src/client.ts - Auth client seam
apps/web/features/auth/lib/auth-client.ts
Data and email
- Postgres / Drizzle
packages/db/src/client.ts - Session queries
packages/db/src/queries/sessions.ts - Email delivery
packages/email/src/send-email.ts - Email templates
packages/email/src/emails - Validated config
packages/env/src/index.ts
Shared interface
- Shared UI components
packages/ui/src/components/shadcn - Responsive sidebar
packages/ui/src/components/shadcn/sidebar.tsx - Brand assets
packages/ui/src/components/brand/logo.tsx
Other components
- Visitor
Connections 20
- Visitor → Web app routes: opens app
apps/web/app/auth/page.tsx - Web app routes → Auth entry: offers sign-in
apps/web/app/auth/page.tsx - Auth entry → Auth screens: renders controls
apps/web/app/auth/page.tsx - Web app routes → Dashboard: serves dashboard
apps/web/app/(app)/dashboard/page.tsx - Dashboard → App shell: renders within
apps/web/app/(app)/dashboard/page.tsx - Dashboard → Session queries: reads session
apps/web/app/(app)/dashboard/page.tsx - Web app routes → Auth API mount: mounts API
apps/web/app/api/auth/[...all]/route.ts - Auth API mount → Better Auth server: adapts handler
apps/web/app/api/auth/[...all]/route.ts - Better Auth server → Postgres / Drizzle: uses adapter
packages/auth/src/auth.ts - Better Auth server → Session queries: checks sessions
packages/auth/src/auth.ts - Better Auth server → Email delivery: sends notices
packages/auth/src/auth.ts - Better Auth server → Validated config: reads config
packages/auth/src/auth.ts - Better Auth server → Email templates: selects messages
- Auth client seam → Browser auth client: re-exports client
apps/web/features/auth/lib/auth-client.ts - App shell → Theme controls: provides controls
- App shell → Notifications: hosts bell
- App shell → Responsive sidebar: uses navigation
- Responsive sidebar → Shared UI components: uses primitives
packages/ui/src/components/shadcn/sidebar.tsx - Shared UI components → Brand assets: includes branding
- Email delivery → Email templates: delivers rendered mail