# abdulbaseer135/abdul-baseer-mern-10pshine architecture

> Architecture diagram of the GitHub repository abdulbaseer135/abdul-baseer-mern-10pshine, 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/abdulbaseer135/abdul-baseer-mern-10pshine
- Repository: https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine

## Overview

This is a MERN notes application. Users sign up or log in, then manage notes from a searchable, sortable dashboard; they can also edit profiles and access publicly shared notes. The frontend sends REST requests to an Express API, whose controllers delegate business operations to services and data access code backed by MongoDB. Authentication includes email OTP verification and password reset; note features include import/export, pinning, and sharing. Source evidence is sampled, so unsampled subsystem connections are omitted rather than inferred.

Main entry points: [`frontend/src/App.jsx`](https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/frontend/src/App.jsx) (App routing), [`backend/src/app.js`](https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/backend/src/app.js) (Express app), [`backend/src/routes`](https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/tree/develop/backend/src/routes) (API routes), [`backend/src/services/auth.service.js`](https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/backend/src/services/auth.service.js) (Auth service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_webapp["App routing<br/>[App.jsx]"]
  node_authpages["Auth pages"]
  node_authhook["Auth state<br/>[useAuth.js]"]
  node_authclient["Auth requests<br/>[auth.service.js]"]
  node_apiclient["HTTP client<br/>[api.js]"]
  node_dashboard["Notes dashboard<br/>[DashboardPage.jsx]"]
  node_dashboardops["Dashboard actions"]
  node_notesclient["Notes requests<br/>[notes.service.js]"]
  node_profile["Profile page<br/>[ProfilePage.jsx]"]
  node_sharedpage["Shared note view<br/>[SharedNotePage.jsx]"]
end

subgraph group_api["API and workflows"]
  node_apiapp["Express app<br/>[app.js]"]
  node_routes["API routes"]
  node_authcontroller["Auth controller<br/>[auth.controller.js]"]
  node_authservice["Auth service<br/>[auth.service.js]"]
  node_notescontroller["Notes controller"]
  node_notesservice["Notes service<br/>[notes.service.js]"]
  node_profilecontroller["Profile controller"]
end

subgraph group_data["Persistence and integrations"]
  node_usersdal["User data access<br/>[users.dal.js]"]
  node_notesdal["Notes data access<br/>[notes.dal.js]"]
  node_models["Mongo models"]
  node_mongodb[("MongoDB")]
  node_email["Email delivery"]
end

node_user(("User"))

node_user -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_authpages
node_webapp -->|"routes to"| node_dashboard
node_webapp -->|"routes to"| node_profile
node_webapp -->|"routes to"| node_sharedpage
node_authpages -->|"uses"| node_authhook
node_authhook -->|"dispatches"| node_authclient
node_authclient -->|"sends requests"| node_apiclient
node_dashboard -->|"uses"| node_dashboardops
node_dashboardops -->|"calls"| node_notesclient
node_profile -->|"uses"| node_authhook
node_sharedpage -->|"fetches shared note"| node_notesclient
node_notesclient -->|"sends requests"| node_apiclient
node_apiclient -.->|"HTTP API"| node_apiapp
node_apiapp -->|"mounts"| node_routes
node_routes -->|"routes auth requests"| node_authcontroller
node_routes -->|"routes note requests"| node_notescontroller
node_authcontroller -->|"calls"| node_authservice
node_notescontroller -->|"calls"| node_notesservice
node_notesservice -->|"queries"| node_notesdal
node_authservice -->|"queries"| node_usersdal
node_authservice -->|"sends OTP email"| node_email
node_usersdal -->|"uses user model"| node_models
node_notesdal -->|"uses note model"| node_models
node_apiapp -->|"connects before API"| node_mongodb
node_profilecontroller -->|"queries"| node_usersdal

click node_webapp "https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/frontend/src/App.jsx"
click node_authpages "https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/tree/develop/frontend/src/pages/AuthPage"
click node_authhook "https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/frontend/src/hooks/useAuth.js"
click node_authclient "https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/frontend/src/services/auth.service.js"
click node_apiclient "https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/frontend/src/services/api.js"
click node_dashboard "https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/frontend/src/pages/DashboardPage/DashboardPage.jsx"
click node_dashboardops "https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/frontend/src/hooks/useDashboardHandlers.js"
click node_notesclient "https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/frontend/src/services/notes.service.js"
click node_profile "https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/frontend/src/pages/ProfilePage/ProfilePage.jsx"
click node_sharedpage "https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/frontend/src/pages/SharedNotePage/SharedNotePage.jsx"
click node_apiapp "https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/backend/src/app.js"
click node_routes "https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/tree/develop/backend/src/routes"
click node_authcontroller "https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/backend/src/controllers/auth.controller.js"
click node_authservice "https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/backend/src/services/auth.service.js"
click node_notescontroller "https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/backend/src/controllers/notes.controller.js"
click node_notesservice "https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/backend/src/services/notes.service.js"
click node_profilecontroller "https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/backend/src/controllers/profile.controller.js"
click node_usersdal "https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/backend/src/dal/users.dal.js"
click node_notesdal "https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/backend/src/dal/notes.dal.js"
click node_models "https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/tree/develop/backend/src/models"

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_webapp,node_authpages,node_authhook,node_authclient,node_apiclient,node_dashboard,node_dashboardops,node_notesclient,node_profile,node_sharedpage,node_user toneBlue
class node_apiapp,node_routes,node_authcontroller,node_authservice,node_notescontroller,node_notesservice,node_profilecontroller toneAmber
class node_usersdal,node_notesdal,node_models,node_mongodb,node_email toneMint
```

## Components

### Web client

- [App routing](https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Auth pages](https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/tree/develop/frontend/src/pages/AuthPage): `frontend/src/pages/AuthPage`
- [Auth state](https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/frontend/src/hooks/useAuth.js): `frontend/src/hooks/useAuth.js`
- [Auth requests](https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/frontend/src/services/auth.service.js): `frontend/src/services/auth.service.js`
- [HTTP client](https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Notes dashboard](https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/frontend/src/pages/DashboardPage/DashboardPage.jsx): `frontend/src/pages/DashboardPage/DashboardPage.jsx`
- [Dashboard actions](https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/frontend/src/hooks/useDashboardHandlers.js): `frontend/src/hooks/useDashboardHandlers.js`
- [Notes requests](https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/frontend/src/services/notes.service.js): `frontend/src/services/notes.service.js`
- [Profile page](https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/frontend/src/pages/ProfilePage/ProfilePage.jsx): `frontend/src/pages/ProfilePage/ProfilePage.jsx`
- [Shared note view](https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/frontend/src/pages/SharedNotePage/SharedNotePage.jsx): `frontend/src/pages/SharedNotePage/SharedNotePage.jsx`

### API and workflows

- [Express app](https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/backend/src/app.js): `backend/src/app.js`
- [API routes](https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/tree/develop/backend/src/routes): `backend/src/routes`
- [Auth controller](https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/backend/src/controllers/auth.controller.js): `backend/src/controllers/auth.controller.js`
- [Auth service](https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/backend/src/services/auth.service.js): `backend/src/services/auth.service.js`
- [Notes controller](https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/backend/src/controllers/notes.controller.js): `backend/src/controllers/notes.controller.js`
- [Notes service](https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/backend/src/services/notes.service.js): `backend/src/services/notes.service.js`
- [Profile controller](https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/backend/src/controllers/profile.controller.js): `backend/src/controllers/profile.controller.js`

### Persistence and integrations

- [User data access](https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/backend/src/dal/users.dal.js): `backend/src/dal/users.dal.js`
- [Notes data access](https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/blob/develop/backend/src/dal/notes.dal.js): `backend/src/dal/notes.dal.js`
- [Mongo models](https://github.com/abdulbaseer135/abdul-baseer-mern-10pshine/tree/develop/backend/src/models): `backend/src/models`
- **MongoDB**
- **Email delivery**

### Other components

- **User**

## Connections

- User → App routing: uses (evidence: `frontend/src/App.jsx`)
- App routing → Auth pages: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Notes dashboard: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Profile page: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Shared note view: routes to (evidence: `frontend/src/App.jsx`)
- Auth pages → Auth state: uses (evidence: `frontend/src/pages/AuthPage/LoginPage.jsx`)
- Auth state → Auth requests: dispatches (evidence: `frontend/src/hooks/useAuth.js`)
- Auth requests → HTTP client: sends requests (evidence: `frontend/src/services/auth.service.js`)
- Notes dashboard → Dashboard actions: uses (evidence: `frontend/src/pages/DashboardPage/DashboardPage.jsx`)
- Dashboard actions → Notes requests: calls (evidence: `frontend/src/hooks/useDashboardHandlers.js`)
- Profile page → Auth state: uses (evidence: `frontend/src/pages/ProfilePage/ProfilePage.jsx`)
- Shared note view → Notes requests: fetches shared note (evidence: `frontend/src/pages/SharedNotePage/SharedNotePage.jsx`)
- Notes requests → HTTP client: sends requests (evidence: `frontend/src/services/notes.service.js`)
- HTTP client → Express app: HTTP API (evidence: `README.md`)
- Express app → API routes: mounts (evidence: `backend/src/app.js`)
- API routes → Auth controller: routes auth requests (evidence: `backend/src/routes/auth.routes.js`)
- API routes → Notes controller: routes note requests (evidence: `backend/src/routes/notes.routes.js`)
- Auth controller → Auth service: calls (evidence: `backend/src/controllers/auth.controller.js`)
- Notes controller → Notes service: calls (evidence: `backend/src/controllers/notes.controller.js`)
- Notes service → Notes data access: queries (evidence: `backend/src/services/notes.service.js`)
- Auth service → User data access: queries (evidence: `backend/src/services/auth.service.js`)
- Auth service → Email delivery: sends OTP email (evidence: `backend/src/services/auth.service.js`)
- User data access → Mongo models: uses user model (evidence: `backend/src/dal/users.dal.js`)
- Notes data access → Mongo models: uses note model (evidence: `backend/src/dal/notes.dal.js`)
- Express app → MongoDB: connects before API (evidence: `backend/src/app.js`)
- Profile controller → User data access: queries (evidence: `backend/src/controllers/profile.controller.js`)
