# dityaren/project-based-learning-interactive-media architecture

> Architecture diagram of the GitHub repository dityaren/project-based-learning-interactive-media, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dityaren/project-based-learning-interactive-media
- Repository: https://github.com/dityaren/project-based-learning-interactive-media

## Overview

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: [`apps/web/src/routeTree.gen.ts`](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/apps/web/src/routeTree.gen.ts) (Route tree), [`apps/web/src/routes/_auth/app/route.tsx`](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/apps/web/src/routes/_auth/app/route.tsx) (App shell), [`packages/auth/src/auth.ts`](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/packages/auth/src/auth.ts) (Auth service), [`packages/db/src/index.ts`](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/packages/db/src/index.ts) (PostgreSQL database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_router["App router<br/>[router.tsx]"]
  node_route_tree["Route tree<br/>[routeTree.gen.ts]"]
  node_guest["Guest routes<br/>[route.tsx]"]
  node_login["Login page<br/>[login.tsx]"]
  node_signup["Signup page<br/>[signup.tsx]"]
  node_auth_gate["Auth route guard<br/>[route.tsx]"]
  node_app_shell["App shell<br/>[route.tsx]"]
  node_learn["Learning page<br/>[app-learn-page.tsx]"]
  node_projects["Projects page"]
  node_profile["Profile page"]
  node_settings["Settings page"]
  node_docs["Developer cheatsheet<br/>[docs.tsx]"]
  node_auth_api_route["Auth API route<br/>[$.ts]"]
end

subgraph group_auth["Authentication"]
  node_auth_client["Auth client<br/>[auth-client.ts]"]
  node_auth_service["Auth service<br/>[auth.ts]"]
  node_auth_query["Auth query<br/>[queries.ts]"]
  node_auth_functions["Auth server functions<br/>[functions.ts]"]
  node_auth_middleware["Auth middleware<br/>[middleware.ts]"]
  node_permissions["Roles and permissions<br/>[permissions.ts]"]
end

subgraph group_data["Persistence"]
  node_database[("PostgreSQL database<br/>[index.ts]")]
  node_auth_schema["Auth schema<br/>[auth.schema.ts]"]
  node_project_schema["Project schema<br/>[projects.schema.ts]"]
  node_audit["Audit records<br/>[audit.ts]"]
end

subgraph group_platform["Shared platform"]
  node_logger["Structured logging<br/>[server.ts]"]
  node_nitro["Nitro server<br/>[nitro.config.ts]"]
  node_ui["UI primitives<br/>[sidebar.tsx]"]
  node_theme["Theme provider<br/>[theme-provider.tsx]"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens app"| node_router
node_router -->|"uses routes"| node_route_tree
node_route_tree -->|"registers routes"| node_guest
node_route_tree -->|"registers routes"| node_auth_gate
node_route_tree -->|"registers routes"| node_app_shell
node_route_tree -->|"registers routes"| node_login
node_route_tree -->|"registers routes"| node_signup
node_route_tree -->|"registers route"| node_auth_api_route
node_guest -->|"checks session"| node_auth_query
node_auth_gate -->|"checks session"| node_auth_query
node_auth_query -->|"calls function"| node_auth_functions
node_auth_functions -->|"reads session"| node_auth_service
node_auth_service -->|"persists auth"| node_database
node_auth_service -->|"uses schema"| node_auth_schema
node_auth_api_route -->|"delegates auth"| node_auth_service
node_auth_client -->|"configures roles"| node_permissions
node_auth_service -->|"configures roles"| node_permissions
node_auth_middleware -->|"gets user"| node_auth_functions
node_app_shell -->|"renders sidebar"| node_ui
node_app_shell -.->|"renders toggle"| node_theme
node_app_shell -.->|"hosts page"| node_learn
node_app_shell -.->|"hosts page"| node_projects
node_app_shell -.->|"hosts page"| node_profile
node_app_shell -.->|"hosts page"| node_settings
node_projects -.->|"uses project data"| node_project_schema
node_database -.->|"maps tables"| node_project_schema
node_database -.->|"supports auditing"| node_audit
node_nitro -->|"wires request logs"| node_logger

click node_router "https://github.com/dityaren/project-based-learning-interactive-media/blob/main/apps/web/src/router.tsx"
click node_route_tree "https://github.com/dityaren/project-based-learning-interactive-media/blob/main/apps/web/src/routeTree.gen.ts"
click node_guest "https://github.com/dityaren/project-based-learning-interactive-media/blob/main/apps/web/src/routes/_guest/route.tsx"
click node_login "https://github.com/dityaren/project-based-learning-interactive-media/blob/main/apps/web/src/routes/_guest/login.tsx"
click node_signup "https://github.com/dityaren/project-based-learning-interactive-media/blob/main/apps/web/src/routes/_guest/signup.tsx"
click node_auth_gate "https://github.com/dityaren/project-based-learning-interactive-media/blob/main/apps/web/src/routes/_auth/route.tsx"
click node_app_shell "https://github.com/dityaren/project-based-learning-interactive-media/blob/main/apps/web/src/routes/_auth/app/route.tsx"
click node_learn "https://github.com/dityaren/project-based-learning-interactive-media/blob/main/apps/web/src/components/app-learn-page.tsx"
click node_projects "https://github.com/dityaren/project-based-learning-interactive-media/blob/main/apps/web/src/components/app-projects-page.tsx"
click node_profile "https://github.com/dityaren/project-based-learning-interactive-media/blob/main/apps/web/src/components/app-profile-page.tsx"
click node_settings "https://github.com/dityaren/project-based-learning-interactive-media/blob/main/apps/web/src/components/app-settings-page.tsx"
click node_docs "https://github.com/dityaren/project-based-learning-interactive-media/blob/main/apps/web/src/routes/docs.tsx"
click node_auth_api_route "https://github.com/dityaren/project-based-learning-interactive-media/blob/main/apps/web/src/routes/api/auth/%24.ts"
click node_auth_client "https://github.com/dityaren/project-based-learning-interactive-media/blob/main/packages/auth/src/auth-client.ts"
click node_auth_service "https://github.com/dityaren/project-based-learning-interactive-media/blob/main/packages/auth/src/auth.ts"
click node_auth_query "https://github.com/dityaren/project-based-learning-interactive-media/blob/main/packages/auth/src/tanstack/queries.ts"
click node_auth_functions "https://github.com/dityaren/project-based-learning-interactive-media/blob/main/packages/auth/src/tanstack/functions.ts"
click node_auth_middleware "https://github.com/dityaren/project-based-learning-interactive-media/blob/main/packages/auth/src/tanstack/middleware.ts"
click node_permissions "https://github.com/dityaren/project-based-learning-interactive-media/blob/main/packages/auth/src/permissions.ts"
click node_database "https://github.com/dityaren/project-based-learning-interactive-media/blob/main/packages/db/src/index.ts"
click node_auth_schema "https://github.com/dityaren/project-based-learning-interactive-media/blob/main/packages/db/src/schema/auth.schema.ts"
click node_project_schema "https://github.com/dityaren/project-based-learning-interactive-media/blob/main/packages/db/src/schema/projects.schema.ts"
click node_audit "https://github.com/dityaren/project-based-learning-interactive-media/blob/main/packages/db/src/audit.ts"
click node_logger "https://github.com/dityaren/project-based-learning-interactive-media/blob/main/packages/logger/src/server.ts"
click node_nitro "https://github.com/dityaren/project-based-learning-interactive-media/blob/main/apps/web/nitro.config.ts"
click node_ui "https://github.com/dityaren/project-based-learning-interactive-media/blob/main/packages/ui/components/sidebar.tsx"
click node_theme "https://github.com/dityaren/project-based-learning-interactive-media/blob/main/packages/ui/lib/theme-provider.tsx"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_router,node_route_tree,node_guest,node_login,node_signup,node_auth_gate,node_app_shell,node_learn,node_projects,node_profile,node_settings,node_docs,node_auth_api_route toneBlue
class node_auth_client,node_auth_service,node_auth_query,node_auth_functions,node_auth_middleware,node_permissions toneAmber
class node_database,node_auth_schema,node_project_schema,node_audit toneMint
class node_logger,node_nitro,node_ui,node_theme toneRose
class node_visitor toneIndigo
```

## Components

### Web experience

- [App router](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/apps/web/src/router.tsx): `apps/web/src/router.tsx`
- [Route tree](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/apps/web/src/routeTree.gen.ts): `apps/web/src/routeTree.gen.ts`
- [Guest routes](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/apps/web/src/routes/_guest/route.tsx): `apps/web/src/routes/_guest/route.tsx`
- [Login page](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/apps/web/src/routes/_guest/login.tsx): `apps/web/src/routes/_guest/login.tsx`
- [Signup page](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/apps/web/src/routes/_guest/signup.tsx): `apps/web/src/routes/_guest/signup.tsx`
- [Auth route guard](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/apps/web/src/routes/_auth/route.tsx): `apps/web/src/routes/_auth/route.tsx`
- [App shell](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/apps/web/src/routes/_auth/app/route.tsx): `apps/web/src/routes/_auth/app/route.tsx`
- [Learning page](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/apps/web/src/components/app-learn-page.tsx): `apps/web/src/components/app-learn-page.tsx`
- [Projects page](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/apps/web/src/components/app-projects-page.tsx): `apps/web/src/components/app-projects-page.tsx`
- [Profile page](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/apps/web/src/components/app-profile-page.tsx): `apps/web/src/components/app-profile-page.tsx`
- [Settings page](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/apps/web/src/components/app-settings-page.tsx): `apps/web/src/components/app-settings-page.tsx`
- [Developer cheatsheet](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/apps/web/src/routes/docs.tsx): `apps/web/src/routes/docs.tsx`
- [Auth API route](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/apps/web/src/routes/api/auth/%24.ts): `apps/web/src/routes/api/auth/$.ts`

### Authentication

- [Auth client](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/packages/auth/src/auth-client.ts): `packages/auth/src/auth-client.ts`
- [Auth service](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/packages/auth/src/auth.ts): `packages/auth/src/auth.ts`
- [Auth query](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/packages/auth/src/tanstack/queries.ts): `packages/auth/src/tanstack/queries.ts`
- [Auth server functions](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/packages/auth/src/tanstack/functions.ts): `packages/auth/src/tanstack/functions.ts`
- [Auth middleware](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/packages/auth/src/tanstack/middleware.ts): `packages/auth/src/tanstack/middleware.ts`
- [Roles and permissions](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/packages/auth/src/permissions.ts): `packages/auth/src/permissions.ts`

### Persistence

- [PostgreSQL database](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/packages/db/src/index.ts): `packages/db/src/index.ts`
- [Auth schema](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/packages/db/src/schema/auth.schema.ts): `packages/db/src/schema/auth.schema.ts`
- [Project schema](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/packages/db/src/schema/projects.schema.ts): `packages/db/src/schema/projects.schema.ts`
- [Audit records](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/packages/db/src/audit.ts): `packages/db/src/audit.ts`

### Shared platform

- [Structured logging](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/packages/logger/src/server.ts): `packages/logger/src/server.ts`
- [Nitro server](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/apps/web/nitro.config.ts): `apps/web/nitro.config.ts`
- [UI primitives](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/packages/ui/components/sidebar.tsx): `packages/ui/components/sidebar.tsx`
- [Theme provider](https://github.com/dityaren/project-based-learning-interactive-media/blob/main/packages/ui/lib/theme-provider.tsx): `packages/ui/lib/theme-provider.tsx`

### Other components

- **Visitor**

## Connections

- Visitor → App router: opens app (evidence: `apps/web/src/router.tsx`)
- App router → Route tree: uses routes (evidence: `apps/web/src/router.tsx`)
- Route tree → Guest routes: registers routes (evidence: `apps/web/src/routeTree.gen.ts`)
- Route tree → Auth route guard: registers routes (evidence: `apps/web/src/routeTree.gen.ts`)
- Route tree → App shell: registers routes (evidence: `apps/web/src/routeTree.gen.ts`)
- Route tree → Login page: registers routes (evidence: `apps/web/src/routeTree.gen.ts`)
- Route tree → Signup page: registers routes (evidence: `apps/web/src/routeTree.gen.ts`)
- Route tree → Auth API route: registers route (evidence: `apps/web/src/routeTree.gen.ts`)
- Guest routes → Auth query: checks session (evidence: `apps/web/src/routes/_guest/route.tsx`)
- Auth route guard → Auth query: checks session (evidence: `apps/web/src/routes/_auth/route.tsx`)
- Auth query → Auth server functions: calls function (evidence: `packages/auth/src/tanstack/queries.ts`)
- Auth server functions → Auth service: reads session (evidence: `packages/auth/src/tanstack/functions.ts`)
- Auth service → PostgreSQL database: persists auth (evidence: `packages/auth/src/auth.ts`)
- Auth service → Auth schema: uses schema (evidence: `packages/auth/src/auth.ts`)
- Auth API route → Auth service: delegates auth (evidence: `apps/web/src/routes/api/auth/$.ts`)
- Auth client → Roles and permissions: configures roles (evidence: `packages/auth/src/auth-client.ts`)
- Auth service → Roles and permissions: configures roles (evidence: `packages/auth/src/auth.ts`)
- Auth middleware → Auth server functions: gets user (evidence: `packages/auth/src/tanstack/middleware.ts`)
- App shell → UI primitives: renders sidebar (evidence: `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 (evidence: `packages/db/src/audit.ts`)
- Nitro server → Structured logging: wires request logs (evidence: `README.md`)
