# sadab14/campusflow architecture

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

- Interactive diagram: https://gitdiagram.com/sadab14/campusflow
- Repository: https://github.com/sadab14/campusflow

## Overview

CampusFlow is a student course-planning web app. Students register or sign in, manage courses, and organize course work as notes, tasks, events, and uploaded files; they can then review deadlines in the calendar and dashboard, with reminders highlighted on the dashboard. The frontend routes views and sends API requests to an Express backend, whose controllers use MongoDB models. The README documents the broader feature set, while the sampled code confirms key course, block, and authentication flows; unsampled feature internals are represented at their exact enclosing paths.

Main entry points: [`frontend/src/App.js`](https://github.com/sadab14/campusflow/blob/main/frontend/src/App.js) (App routes), [`frontend/src/services/api.js`](https://github.com/sadab14/campusflow/blob/main/frontend/src/services/api.js) (API client), [`backend/routes`](https://github.com/sadab14/campusflow/tree/main/backend/routes) (REST routes), [`frontend/src/pages/DashboardPage.js`](https://github.com/sadab14/campusflow/blob/main/frontend/src/pages/DashboardPage.js) (Dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Student interface"]
  node_app["App routes<br/>[App.js]"]
  node_auth_ui["Sign in/up<br/>[Register.js]"]
  node_auth_context["Auth state<br/>[AuthContext.js]"]
  node_course_list["Course list<br/>[CourseList.js]"]
  node_course_create["Create course<br/>[CreateCourse.js]"]
  node_course_detail["Course workspace<br/>[CourseDetail.js]"]
  node_calendar["Calendar<br/>[CalendarView.js]"]
  node_dashboard["Dashboard<br/>[DashboardPage.js]"]
  node_reminders["Reminder banner<br/>[ReminderBanner.js]"]
  node_landing["Landing page<br/>[LandingPage.js]"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_backend["Application API"]
  node_server["HTTP server<br/>[server.js]"]
  node_routes["REST routes"]
  node_auth_controller["Authentication<br/>[authController.js]"]
  node_course_controller["Course management"]
  node_block_controller["Block management<br/>[blockController.js]"]
  node_auth_middleware["JWT middleware<br/>[auth.js]"]
end

subgraph group_data["Persistence"]
  node_user_model["User model<br/>[User.js]"]
  node_course_model["Course model<br/>[Course.js]"]
  node_block_model["Block model<br/>[Block.js]"]
end

node_student(("Student"))
node_mongo[("MongoDB")]

node_student -->|"uses"| node_app
node_app -->|"routes to"| node_auth_ui
node_app -->|"routes to"| node_course_list
node_app -->|"routes to"| node_course_create
node_app -->|"routes to"| node_course_detail
node_app -->|"routes to"| node_calendar
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_landing
node_app -->|"provides auth"| node_auth_context
node_auth_ui -->|"uses"| node_auth_context
node_auth_context -->|"requests auth"| node_api_client
node_course_list -->|"requests courses"| node_api_client
node_course_create -->|"requests courses"| node_api_client
node_course_detail -->|"requests course data"| node_api_client
node_calendar -->|"requests data"| node_api_client
node_dashboard -->|"requests data"| node_api_client
node_dashboard -->|"renders"| node_reminders
node_api_client -.->|"sends HTTP requests"| node_server
node_server -->|"mounts"| node_routes
node_routes -->|"dispatches auth"| node_auth_controller
node_routes -->|"dispatches courses"| node_course_controller
node_routes -->|"dispatches blocks"| node_block_controller
node_routes -->|"protects requests"| node_auth_middleware
node_auth_controller -->|"reads/writes users"| node_user_model
node_auth_middleware -->|"checks user"| node_user_model
node_course_controller -->|"reads/writes courses"| node_course_model
node_course_controller -->|"deletes course blocks"| node_block_model
node_block_controller -->|"checks course"| node_course_model
node_block_controller -->|"reads/writes blocks"| node_block_model
node_user_model -.->|"persists users"| node_mongo
node_course_model -.->|"persists courses"| node_mongo
node_block_model -.->|"persists blocks"| node_mongo

click node_app "https://github.com/sadab14/campusflow/blob/main/frontend/src/App.js"
click node_auth_ui "https://github.com/sadab14/campusflow/blob/main/frontend/src/components/Register.js"
click node_auth_context "https://github.com/sadab14/campusflow/blob/main/frontend/src/context/AuthContext.js"
click node_course_list "https://github.com/sadab14/campusflow/blob/main/frontend/src/pages/CourseList.js"
click node_course_create "https://github.com/sadab14/campusflow/blob/main/frontend/src/pages/CreateCourse.js"
click node_course_detail "https://github.com/sadab14/campusflow/blob/main/frontend/src/pages/CourseDetail.js"
click node_calendar "https://github.com/sadab14/campusflow/blob/main/frontend/src/pages/CalendarView.js"
click node_dashboard "https://github.com/sadab14/campusflow/blob/main/frontend/src/pages/DashboardPage.js"
click node_reminders "https://github.com/sadab14/campusflow/blob/main/frontend/src/components/ReminderBanner.js"
click node_landing "https://github.com/sadab14/campusflow/blob/main/frontend/src/pages/LandingPage.js"
click node_api_client "https://github.com/sadab14/campusflow/blob/main/frontend/src/services/api.js"
click node_server "https://github.com/sadab14/campusflow/blob/main/backend/server.js"
click node_routes "https://github.com/sadab14/campusflow/tree/main/backend/routes"
click node_auth_controller "https://github.com/sadab14/campusflow/blob/main/backend/controllers/authController.js"
click node_course_controller "https://github.com/sadab14/campusflow/blob/main/backend/controllers/courseController.js"
click node_block_controller "https://github.com/sadab14/campusflow/blob/main/backend/controllers/blockController.js"
click node_auth_middleware "https://github.com/sadab14/campusflow/blob/main/backend/middleware/auth.js"
click node_user_model "https://github.com/sadab14/campusflow/blob/main/backend/models/User.js"
click node_course_model "https://github.com/sadab14/campusflow/blob/main/backend/models/Course.js"
click node_block_model "https://github.com/sadab14/campusflow/blob/main/backend/models/Block.js"

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_app,node_auth_ui,node_auth_context,node_course_list,node_course_create,node_course_detail,node_calendar,node_dashboard,node_reminders,node_landing,node_api_client toneBlue
class node_server,node_routes,node_auth_controller,node_course_controller,node_block_controller,node_auth_middleware,node_mongo toneAmber
class node_user_model,node_course_model,node_block_model toneMint
class node_student toneIndigo
```

## Components

### Student interface

- [App routes](https://github.com/sadab14/campusflow/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Sign in/up](https://github.com/sadab14/campusflow/blob/main/frontend/src/components/Register.js): `frontend/src/components/Register.js`
- [Auth state](https://github.com/sadab14/campusflow/blob/main/frontend/src/context/AuthContext.js): `frontend/src/context/AuthContext.js`
- [Course list](https://github.com/sadab14/campusflow/blob/main/frontend/src/pages/CourseList.js): `frontend/src/pages/CourseList.js`
- [Create course](https://github.com/sadab14/campusflow/blob/main/frontend/src/pages/CreateCourse.js): `frontend/src/pages/CreateCourse.js`
- [Course workspace](https://github.com/sadab14/campusflow/blob/main/frontend/src/pages/CourseDetail.js): `frontend/src/pages/CourseDetail.js`
- [Calendar](https://github.com/sadab14/campusflow/blob/main/frontend/src/pages/CalendarView.js): `frontend/src/pages/CalendarView.js`
- [Dashboard](https://github.com/sadab14/campusflow/blob/main/frontend/src/pages/DashboardPage.js): `frontend/src/pages/DashboardPage.js`
- [Reminder banner](https://github.com/sadab14/campusflow/blob/main/frontend/src/components/ReminderBanner.js): `frontend/src/components/ReminderBanner.js`
- [Landing page](https://github.com/sadab14/campusflow/blob/main/frontend/src/pages/LandingPage.js): `frontend/src/pages/LandingPage.js`
- [API client](https://github.com/sadab14/campusflow/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### Application API

- [HTTP server](https://github.com/sadab14/campusflow/blob/main/backend/server.js): `backend/server.js`
- [REST routes](https://github.com/sadab14/campusflow/tree/main/backend/routes): `backend/routes`
- [Authentication](https://github.com/sadab14/campusflow/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [Course management](https://github.com/sadab14/campusflow/blob/main/backend/controllers/courseController.js): `backend/controllers/courseController.js`
- [Block management](https://github.com/sadab14/campusflow/blob/main/backend/controllers/blockController.js): `backend/controllers/blockController.js`
- [JWT middleware](https://github.com/sadab14/campusflow/blob/main/backend/middleware/auth.js): `backend/middleware/auth.js`

### Persistence

- [User model](https://github.com/sadab14/campusflow/blob/main/backend/models/User.js): `backend/models/User.js`
- [Course model](https://github.com/sadab14/campusflow/blob/main/backend/models/Course.js): `backend/models/Course.js`
- [Block model](https://github.com/sadab14/campusflow/blob/main/backend/models/Block.js): `backend/models/Block.js`

### Other components

- **Student**
- **MongoDB**

## Connections

- Student → App routes: uses (evidence: `frontend/src/App.js`)
- App routes → Sign in/up: routes to (evidence: `frontend/src/App.js`)
- App routes → Course list: routes to (evidence: `frontend/src/App.js`)
- App routes → Create course: routes to (evidence: `frontend/src/App.js`)
- App routes → Course workspace: routes to (evidence: `frontend/src/App.js`)
- App routes → Calendar: routes to (evidence: `frontend/src/App.js`)
- App routes → Dashboard: routes to (evidence: `frontend/src/App.js`)
- App routes → Landing page: routes to (evidence: `frontend/src/App.js`)
- App routes → Auth state: provides auth (evidence: `frontend/src/App.js`)
- Sign in/up → Auth state: uses (evidence: `frontend/src/components/Register.js`)
- Auth state → API client: requests auth (evidence: `frontend/src/context/AuthContext.js`)
- Course list → API client: requests courses (evidence: `frontend/src/services/api.js`)
- Create course → API client: requests courses (evidence: `frontend/src/services/api.js`)
- Course workspace → API client: requests course data (evidence: `frontend/src/pages/CourseDetail.js`)
- Calendar → API client: requests data (evidence: `frontend/src/pages/CalendarView.js`)
- Dashboard → API client: requests data (evidence: `frontend/src/pages/DashboardPage.js`)
- Dashboard → Reminder banner: renders (evidence: `frontend/src/pages/DashboardPage.js`)
- API client → HTTP server: sends HTTP requests
- HTTP server → REST routes: mounts (evidence: `backend/server.js`)
- REST routes → Authentication: dispatches auth (evidence: `backend/routes/auth.js`)
- REST routes → Course management: dispatches courses (evidence: `backend/routes/courses.js`)
- REST routes → Block management: dispatches blocks (evidence: `backend/routes/blocks.js`)
- REST routes → JWT middleware: protects requests (evidence: `backend/routes/auth.js`)
- Authentication → User model: reads/writes users (evidence: `backend/controllers/authController.js`)
- JWT middleware → User model: checks user (evidence: `backend/middleware/auth.js`)
- Course management → Course model: reads/writes courses (evidence: `backend/controllers/courseController.js`)
- Course management → Block model: deletes course blocks (evidence: `backend/controllers/courseController.js`)
- Block management → Course model: checks course (evidence: `backend/controllers/blockController.js`)
- Block management → Block model: reads/writes blocks (evidence: `backend/controllers/blockController.js`)
- User model → MongoDB: persists users
- Course model → MongoDB: persists courses
- Block model → MongoDB: persists blocks
