How dityaren/project-based-learning-interactive-media works
This repository is a web application starter for interactive, project-based learning media. A visitor reaches the guest login or signup flow; authenticated users enter the app shell and can access learning, projects, profile, and settings pages. The app also includes a docs/cheatsheet route, role-aware Better Auth, and PostgreSQL-backed Drizzle schemas. The graph shows documented route structure and sampled auth calls; several feature pages and their data flows were not sampled, so their internal links are omitted. Nitro request logging is documented, but its wiring is not shown in source excerpts.
Main entry points: routeTree.gen.ts Route tree · route.tsx App shell · auth.ts Auth service · index.ts PostgreSQL database
Components 28
Web experience
- App router
apps/web/src/router.tsx - Route tree
apps/web/src/routeTree.gen.ts - Guest routes
apps/web/src/routes/_guest/route.tsx - Login page
apps/web/src/routes/_guest/login.tsx - Signup page
apps/web/src/routes/_guest/signup.tsx - Auth route guard
apps/web/src/routes/_auth/route.tsx - App shell
apps/web/src/routes/_auth/app/route.tsx - Learning page
apps/web/src/components/app-learn-page.tsx - Projects page
apps/web/src/components/app-projects-page.tsx - Profile page
apps/web/src/components/app-profile-page.tsx - Settings page
apps/web/src/components/app-settings-page.tsx - Developer cheatsheet
apps/web/src/routes/docs.tsx - Auth API route
apps/web/src/routes/api/auth/$.ts
Authentication
- Auth client
packages/auth/src/auth-client.ts - Auth service
packages/auth/src/auth.ts - Auth query
packages/auth/src/tanstack/queries.ts - Auth server functions
packages/auth/src/tanstack/functions.ts - Auth middleware
packages/auth/src/tanstack/middleware.ts - Roles and permissions
packages/auth/src/permissions.ts
Persistence
- PostgreSQL database
packages/db/src/index.ts - Auth schema
packages/db/src/schema/auth.schema.ts - Project schema
packages/db/src/schema/projects.schema.ts - Audit records
packages/db/src/audit.ts
Shared platform
- Structured logging
packages/logger/src/server.ts - Nitro server
apps/web/nitro.config.ts - UI primitives
packages/ui/components/sidebar.tsx - Theme provider
packages/ui/lib/theme-provider.tsx
Other components
- Visitor
Connections 28
- Visitor → App router: opens app
apps/web/src/router.tsx - App router → Route tree: uses routes
apps/web/src/router.tsx - Route tree → Guest routes: registers routes
apps/web/src/routeTree.gen.ts - Route tree → Auth route guard: registers routes
apps/web/src/routeTree.gen.ts - Route tree → App shell: registers routes
apps/web/src/routeTree.gen.ts - Route tree → Login page: registers routes
apps/web/src/routeTree.gen.ts - Route tree → Signup page: registers routes
apps/web/src/routeTree.gen.ts - Route tree → Auth API route: registers route
apps/web/src/routeTree.gen.ts - Guest routes → Auth query: checks session
apps/web/src/routes/_guest/route.tsx - Auth route guard → Auth query: checks session
apps/web/src/routes/_auth/route.tsx - Auth query → Auth server functions: calls function
packages/auth/src/tanstack/queries.ts - Auth server functions → Auth service: reads session
packages/auth/src/tanstack/functions.ts - Auth service → PostgreSQL database: persists auth
packages/auth/src/auth.ts - Auth service → Auth schema: uses schema
packages/auth/src/auth.ts - Auth API route → Auth service: delegates auth
apps/web/src/routes/api/auth/$.ts - Auth client → Roles and permissions: configures roles
packages/auth/src/auth-client.ts - Auth service → Roles and permissions: configures roles
packages/auth/src/auth.ts - Auth middleware → Auth server functions: gets user
packages/auth/src/tanstack/middleware.ts - App shell → UI primitives: renders sidebar
apps/web/src/routes/_auth/app/route.tsx - App shell → Theme provider: renders toggle
- App shell → Learning page: hosts page
- App shell → Projects page: hosts page
- App shell → Profile page: hosts page
- App shell → Settings page: hosts page
- Projects page → Project schema: uses project data
- PostgreSQL database → Project schema: maps tables
- PostgreSQL database → Audit records: supports auditing
packages/db/src/audit.ts - Nitro server → Structured logging: wires request logs
README.md