# heifarabuval/mernauth architecture

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

- Interactive diagram: https://gitdiagram.com/heifarabuval/mernauth
- Repository: https://github.com/heifarabuval/mernauth

## Overview

MernAuth is a MERN authentication and personal-blog application. Users register or log in, then access a protected blog to read and manage posts and comments; account recovery uses a reset link sent by email. The React app routes screens, while Express mounts authentication and protected blog APIs backed by MongoDB models. The README only identifies authentication pages; the post, comment, and recovery capabilities are supported by the sampled source. Some screen implementations and database configuration were not sampled, so their internal calls are not inferred.

Main entry points: [`client/src/App.js`](https://github.com/heifarabuval/mernauth/blob/main/client/src/App.js) (App router), [`server.js`](https://github.com/heifarabuval/mernauth/blob/main/server.js) (Express server), [`client/src/components/screens/Blog.js`](https://github.com/heifarabuval/mernauth/blob/main/client/src/components/screens/Blog.js) (Blog screen), [`routes/blog.js`](https://github.com/heifarabuval/mernauth/blob/main/routes/blog.js) (Blog routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React client"]
  node_app["App router<br/>[App.js]"]
  node_private_route["Private route<br/>[PrivateRoute.js]"]
  node_account_screens["Account screens"]
  node_private_screen["Private screen<br/>[PrivateScreen.js]"]
  node_blog_screen["Blog screen<br/>[Blog.js]"]
  node_add_post["Post editor<br/>[AddPost.js]"]
  node_post_screens["Post detail and edit"]
  node_header["Navigation header<br/>[Header.js]"]
end

subgraph group_auth["Account services"]
  node_auth_routes["Auth routes<br/>[auth.js]"]
  node_auth_controller["Auth operations<br/>[auth.js]"]
  node_user_model[("User account model<br/>[User.js]")]
  node_email_sender["Email sender<br/>[sendEmail.js]"]
end

subgraph group_blog["Blog services"]
  node_blog_routes["Blog routes<br/>[blog.js]"]
  node_auth_middleware["Token protection<br/>[auth.js]"]
  node_blog_controller["Post and comment operations<br/>[blog.js]"]
  node_post_model[("Post model<br/>[Post.js]")]
  node_comment_model[("Comment model<br/>[Comment.js]")]
end

subgraph group_infra["Server and data"]
  node_server["Express server<br/>[server.js]"]
  node_db_config["Database connection<br/>[db.js]"]
  node_error_middleware["Error handler<br/>[error.js]"]
end

node_user(("Visitor"))
node_mail_service(("Email service"))
node_mongo[("MongoDB")]

node_user -->|"uses"| node_app
node_app -->|"routes through"| node_private_route
node_app -->|"routes to"| node_private_screen
node_app -->|"routes to"| node_account_screens
node_app -->|"routes to"| node_blog_screen
node_app -->|"routes to"| node_post_screens
node_blog_screen -->|"renders"| node_add_post
node_blog_screen -->|"renders"| node_header
node_private_screen -->|"uses"| node_header
node_auth_routes -->|"dispatches to"| node_auth_controller
node_auth_controller -->|"reads and writes"| node_user_model
node_auth_controller -->|"sends recovery email"| node_email_sender
node_email_sender -.->|"sends mail"| node_mail_service
node_blog_routes -->|"protects routes"| node_auth_middleware
node_blog_routes -->|"dispatches to"| node_blog_controller
node_auth_middleware -->|"looks up user"| node_user_model
node_blog_controller -->|"reads and writes"| node_post_model
node_blog_controller -->|"creates comments"| node_comment_model
node_blog_screen -->|"calls API"| node_blog_routes
node_server -->|"mounts"| node_auth_routes
node_server -->|"mounts"| node_blog_routes
node_server -->|"connects"| node_db_config
node_db_config -.->|"connects"| node_mongo
node_server -->|"handles errors"| node_error_middleware

click node_app "https://github.com/heifarabuval/mernauth/blob/main/client/src/App.js"
click node_private_route "https://github.com/heifarabuval/mernauth/blob/main/client/src/components/routing/PrivateRoute.js"
click node_account_screens "https://github.com/heifarabuval/mernauth/tree/main/client/src/components/screens"
click node_private_screen "https://github.com/heifarabuval/mernauth/blob/main/client/src/components/screens/PrivateScreen.js"
click node_blog_screen "https://github.com/heifarabuval/mernauth/blob/main/client/src/components/screens/Blog.js"
click node_add_post "https://github.com/heifarabuval/mernauth/blob/main/client/src/components/screens/AddPost.js"
click node_post_screens "https://github.com/heifarabuval/mernauth/tree/main/client/src/components/screens"
click node_header "https://github.com/heifarabuval/mernauth/blob/main/client/src/components/screens/Header.js"
click node_auth_routes "https://github.com/heifarabuval/mernauth/blob/main/routes/auth.js"
click node_auth_controller "https://github.com/heifarabuval/mernauth/blob/main/controllers/auth.js"
click node_user_model "https://github.com/heifarabuval/mernauth/blob/main/models/User.js"
click node_email_sender "https://github.com/heifarabuval/mernauth/blob/main/utils/sendEmail.js"
click node_blog_routes "https://github.com/heifarabuval/mernauth/blob/main/routes/blog.js"
click node_auth_middleware "https://github.com/heifarabuval/mernauth/blob/main/middlewares/auth.js"
click node_blog_controller "https://github.com/heifarabuval/mernauth/blob/main/controllers/blog.js"
click node_post_model "https://github.com/heifarabuval/mernauth/blob/main/models/Post.js"
click node_comment_model "https://github.com/heifarabuval/mernauth/blob/main/models/Comment.js"
click node_server "https://github.com/heifarabuval/mernauth/blob/main/server.js"
click node_db_config "https://github.com/heifarabuval/mernauth/blob/main/config/db.js"
click node_error_middleware "https://github.com/heifarabuval/mernauth/blob/main/middlewares/error.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_private_route,node_account_screens,node_private_screen,node_blog_screen,node_add_post,node_post_screens,node_header toneBlue
class node_auth_routes,node_auth_controller,node_user_model,node_email_sender,node_mongo toneAmber
class node_blog_routes,node_auth_middleware,node_blog_controller,node_post_model,node_comment_model toneMint
class node_server,node_db_config,node_error_middleware toneRose
class node_user,node_mail_service toneIndigo
```

## Components

### React client

- [App router](https://github.com/heifarabuval/mernauth/blob/main/client/src/App.js): `client/src/App.js`
- [Private route](https://github.com/heifarabuval/mernauth/blob/main/client/src/components/routing/PrivateRoute.js): `client/src/components/routing/PrivateRoute.js`
- [Account screens](https://github.com/heifarabuval/mernauth/tree/main/client/src/components/screens): `client/src/components/screens`
- [Private screen](https://github.com/heifarabuval/mernauth/blob/main/client/src/components/screens/PrivateScreen.js): `client/src/components/screens/PrivateScreen.js`
- [Blog screen](https://github.com/heifarabuval/mernauth/blob/main/client/src/components/screens/Blog.js): `client/src/components/screens/Blog.js`
- [Post editor](https://github.com/heifarabuval/mernauth/blob/main/client/src/components/screens/AddPost.js): `client/src/components/screens/AddPost.js`
- [Post detail and edit](https://github.com/heifarabuval/mernauth/tree/main/client/src/components/screens): `client/src/components/screens`
- [Navigation header](https://github.com/heifarabuval/mernauth/blob/main/client/src/components/screens/Header.js): `client/src/components/screens/Header.js`

### Account services

- [Auth routes](https://github.com/heifarabuval/mernauth/blob/main/routes/auth.js): `routes/auth.js`
- [Auth operations](https://github.com/heifarabuval/mernauth/blob/main/controllers/auth.js): `controllers/auth.js`
- [User account model](https://github.com/heifarabuval/mernauth/blob/main/models/User.js): `models/User.js`
- [Email sender](https://github.com/heifarabuval/mernauth/blob/main/utils/sendEmail.js): `utils/sendEmail.js`

### Blog services

- [Blog routes](https://github.com/heifarabuval/mernauth/blob/main/routes/blog.js): `routes/blog.js`
- [Token protection](https://github.com/heifarabuval/mernauth/blob/main/middlewares/auth.js): `middlewares/auth.js`
- [Post and comment operations](https://github.com/heifarabuval/mernauth/blob/main/controllers/blog.js): `controllers/blog.js`
- [Post model](https://github.com/heifarabuval/mernauth/blob/main/models/Post.js): `models/Post.js`
- [Comment model](https://github.com/heifarabuval/mernauth/blob/main/models/Comment.js): `models/Comment.js`

### Server and data

- [Express server](https://github.com/heifarabuval/mernauth/blob/main/server.js): `server.js`
- [Database connection](https://github.com/heifarabuval/mernauth/blob/main/config/db.js): `config/db.js`
- [Error handler](https://github.com/heifarabuval/mernauth/blob/main/middlewares/error.js): `middlewares/error.js`

### Other components

- **Visitor**
- **Email service**
- **MongoDB**

## Connections

- Visitor → App router: uses (evidence: `client/src/App.js`)
- App router → Private route: routes through (evidence: `client/src/App.js`)
- App router → Private screen: routes to (evidence: `client/src/App.js`)
- App router → Account screens: routes to (evidence: `client/src/App.js`)
- App router → Blog screen: routes to (evidence: `client/src/App.js`)
- App router → Post detail and edit: routes to (evidence: `client/src/App.js`)
- Blog screen → Post editor: renders (evidence: `client/src/components/screens/Blog.js`)
- Blog screen → Navigation header: renders (evidence: `client/src/components/screens/Blog.js`)
- Private screen → Navigation header: uses (evidence: `client/src/components/screens/PrivateScreen.js`)
- Auth routes → Auth operations: dispatches to (evidence: `routes/auth.js`)
- Auth operations → User account model: reads and writes (evidence: `controllers/auth.js`)
- Auth operations → Email sender: sends recovery email (evidence: `controllers/auth.js`)
- Email sender → Email service: sends mail (evidence: `utils/sendEmail.js`)
- Blog routes → Token protection: protects routes (evidence: `routes/blog.js`)
- Blog routes → Post and comment operations: dispatches to (evidence: `routes/blog.js`)
- Token protection → User account model: looks up user (evidence: `middlewares/auth.js`)
- Post and comment operations → Post model: reads and writes (evidence: `controllers/blog.js`)
- Post and comment operations → Comment model: creates comments (evidence: `controllers/blog.js`)
- Blog screen → Blog routes: calls API (evidence: `client/src/components/screens/Blog.js`)
- Express server → Auth routes: mounts (evidence: `server.js`)
- Express server → Blog routes: mounts (evidence: `server.js`)
- Express server → Database connection: connects (evidence: `server.js`)
- Database connection → MongoDB: connects
- Express server → Error handler: handles errors (evidence: `server.js`)
