# smayanja3/binary-upload-boom architecture

> Architecture diagram of the GitHub repository smayanja3/binary-upload-boom, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/smayanja3/binary-upload-boom
- Repository: https://github.com/smayanja3/binary-upload-boom

## Overview

This is an Express/Mongoose image-sharing application. Users sign up or log in, create image posts, browse a feed or their profile, and view posts with comments and likes. Routes dispatch requests to controllers; those controllers coordinate persistence and image hosting, then render pages or redirect. The README confirms Cloudinary configuration but does not describe product behavior; connections involving sampled code are shown only where the excerpts or source index support them.

Main entry points: [`server.js`](https://github.com/smayanja3/binary-upload-boom/blob/answer/server.js) (Express server), [`controllers/posts.js`](https://github.com/smayanja3/binary-upload-boom/blob/answer/controllers/posts.js) (Posts controller), [`routes/main.js`](https://github.com/smayanja3/binary-upload-boom/blob/answer/routes/main.js) (Main routes), [`routes/posts.js`](https://github.com/smayanja3/binary-upload-boom/blob/answer/routes/posts.js) (Post routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Web entry and routing"]
  node_server["Express server<br/>[server.js]"]
  node_mainroutes["Main routes<br/>[main.js]"]
  node_postroutes["Post routes<br/>[posts.js]"]
  node_commentroutes["Comment routes<br/>[comment.js]"]
  node_home["Home controller<br/>[home.js]"]
  node_views["EJS pages"]
end

subgraph group_identity["Accounts and sessions"]
  node_authcontroller["Auth controller<br/>[auth.js]"]
  node_authmiddleware["Auth middleware<br/>[auth.js]"]
  node_passport["Local authentication<br/>[passport.js]"]
  node_users[("User model<br/>[User.js]")]
end

subgraph group_social["Posts and comments"]
  node_postscontroller["Posts controller<br/>[posts.js]"]
  node_commentscontroller["Comments controller<br/>[comments.js]"]
  node_postmodel[("Post model<br/>[Post.js]")]
  node_commentmodel[("Comment model<br/>[Comment.js]")]
end

subgraph group_services["Persistence and media"]
  node_upload["Image upload filter<br/>[multer.js]"]
  node_cloudinary["Cloudinary media<br/>[cloudinary.js]"]
  node_database["MongoDB connection<br/>[database.js]"]
end

node_visitor(("Visitor"))

node_visitor -->|"sends requests"| node_server
node_server -->|"mounts routes"| node_mainroutes
node_server -->|"mounts routes"| node_postroutes
node_server -->|"mounts routes"| node_commentroutes
node_server -->|"connects database"| node_database
node_server -->|"configures auth"| node_passport
node_mainroutes -->|"dispatches home"| node_home
node_mainroutes -->|"dispatches auth"| node_authcontroller
node_mainroutes -->|"dispatches profile/feed"| node_postscontroller
node_mainroutes -->|"guards pages"| node_authmiddleware
node_postroutes -->|"dispatches posts"| node_postscontroller
node_postroutes -->|"guards post view"| node_authmiddleware
node_postroutes -->|"filters uploads"| node_upload
node_commentroutes -->|"dispatches comments"| node_commentscontroller
node_commentroutes -->|"uses upload filter"| node_upload
node_authcontroller -->|"queries users"| node_users
node_passport -->|"authenticates users"| node_users
node_postscontroller -->|"reads/writes posts"| node_postmodel
node_postscontroller -->|"reads comments"| node_commentmodel
node_postscontroller -->|"uploads/deletes media"| node_cloudinary
node_commentscontroller -->|"uses comments"| node_commentmodel
node_authcontroller -->|"renders auth pages"| node_views
node_postscontroller -->|"renders post pages"| node_views

click node_server "https://github.com/smayanja3/binary-upload-boom/blob/answer/server.js"
click node_mainroutes "https://github.com/smayanja3/binary-upload-boom/blob/answer/routes/main.js"
click node_postroutes "https://github.com/smayanja3/binary-upload-boom/blob/answer/routes/posts.js"
click node_commentroutes "https://github.com/smayanja3/binary-upload-boom/blob/answer/routes/comment.js"
click node_home "https://github.com/smayanja3/binary-upload-boom/blob/answer/controllers/home.js"
click node_views "https://github.com/smayanja3/binary-upload-boom/tree/answer/views"
click node_authcontroller "https://github.com/smayanja3/binary-upload-boom/blob/answer/controllers/auth.js"
click node_authmiddleware "https://github.com/smayanja3/binary-upload-boom/blob/answer/middleware/auth.js"
click node_passport "https://github.com/smayanja3/binary-upload-boom/blob/answer/config/passport.js"
click node_users "https://github.com/smayanja3/binary-upload-boom/blob/answer/models/User.js"
click node_postscontroller "https://github.com/smayanja3/binary-upload-boom/blob/answer/controllers/posts.js"
click node_commentscontroller "https://github.com/smayanja3/binary-upload-boom/blob/answer/controllers/comments.js"
click node_postmodel "https://github.com/smayanja3/binary-upload-boom/blob/answer/models/Post.js"
click node_commentmodel "https://github.com/smayanja3/binary-upload-boom/blob/answer/models/Comment.js"
click node_upload "https://github.com/smayanja3/binary-upload-boom/blob/answer/middleware/multer.js"
click node_cloudinary "https://github.com/smayanja3/binary-upload-boom/blob/answer/middleware/cloudinary.js"
click node_database "https://github.com/smayanja3/binary-upload-boom/blob/answer/config/database.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_server,node_mainroutes,node_postroutes,node_commentroutes,node_home,node_views toneBlue
class node_authcontroller,node_authmiddleware,node_passport,node_users toneAmber
class node_postscontroller,node_commentscontroller,node_postmodel,node_commentmodel toneMint
class node_upload,node_cloudinary,node_database toneRose
class node_visitor toneIndigo
```

## Components

### Web entry and routing

- [Express server](https://github.com/smayanja3/binary-upload-boom/blob/answer/server.js): `server.js`
- [Main routes](https://github.com/smayanja3/binary-upload-boom/blob/answer/routes/main.js): `routes/main.js`
- [Post routes](https://github.com/smayanja3/binary-upload-boom/blob/answer/routes/posts.js): `routes/posts.js`
- [Comment routes](https://github.com/smayanja3/binary-upload-boom/blob/answer/routes/comment.js): `routes/comment.js`
- [Home controller](https://github.com/smayanja3/binary-upload-boom/blob/answer/controllers/home.js): `controllers/home.js`
- [EJS pages](https://github.com/smayanja3/binary-upload-boom/tree/answer/views): `views`

### Accounts and sessions

- [Auth controller](https://github.com/smayanja3/binary-upload-boom/blob/answer/controllers/auth.js): `controllers/auth.js`
- [Auth middleware](https://github.com/smayanja3/binary-upload-boom/blob/answer/middleware/auth.js): `middleware/auth.js`
- [Local authentication](https://github.com/smayanja3/binary-upload-boom/blob/answer/config/passport.js): `config/passport.js`
- [User model](https://github.com/smayanja3/binary-upload-boom/blob/answer/models/User.js): `models/User.js`

### Posts and comments

- [Posts controller](https://github.com/smayanja3/binary-upload-boom/blob/answer/controllers/posts.js): `controllers/posts.js`
- [Comments controller](https://github.com/smayanja3/binary-upload-boom/blob/answer/controllers/comments.js): `controllers/comments.js`
- [Post model](https://github.com/smayanja3/binary-upload-boom/blob/answer/models/Post.js): `models/Post.js`
- [Comment model](https://github.com/smayanja3/binary-upload-boom/blob/answer/models/Comment.js): `models/Comment.js`

### Persistence and media

- [Image upload filter](https://github.com/smayanja3/binary-upload-boom/blob/answer/middleware/multer.js): `middleware/multer.js`
- [Cloudinary media](https://github.com/smayanja3/binary-upload-boom/blob/answer/middleware/cloudinary.js): `middleware/cloudinary.js`
- [MongoDB connection](https://github.com/smayanja3/binary-upload-boom/blob/answer/config/database.js): `config/database.js`

### Other components

- **Visitor**

## Connections

- Visitor → Express server: sends requests
- Express server → Main routes: mounts routes (evidence: `server.js`)
- Express server → Post routes: mounts routes (evidence: `server.js`)
- Express server → Comment routes: mounts routes (evidence: `server.js`)
- Express server → MongoDB connection: connects database (evidence: `server.js`)
- Express server → Local authentication: configures auth (evidence: `server.js`)
- Main routes → Home controller: dispatches home (evidence: `routes/main.js`)
- Main routes → Auth controller: dispatches auth (evidence: `routes/main.js`)
- Main routes → Posts controller: dispatches profile/feed (evidence: `routes/main.js`)
- Main routes → Auth middleware: guards pages (evidence: `routes/main.js`)
- Post routes → Posts controller: dispatches posts (evidence: `routes/posts.js`)
- Post routes → Auth middleware: guards post view (evidence: `routes/posts.js`)
- Post routes → Image upload filter: filters uploads (evidence: `routes/posts.js`)
- Comment routes → Comments controller: dispatches comments (evidence: `routes/comment.js`)
- Comment routes → Image upload filter: uses upload filter (evidence: `routes/comment.js`)
- Auth controller → User model: queries users (evidence: `controllers/auth.js`)
- Local authentication → User model: authenticates users (evidence: `config/passport.js`)
- Posts controller → Post model: reads/writes posts (evidence: `controllers/posts.js`)
- Posts controller → Comment model: reads comments (evidence: `controllers/posts.js`)
- Posts controller → Cloudinary media: uploads/deletes media (evidence: `controllers/posts.js`)
- Comments controller → Comment model: uses comments (evidence: `controllers/comments.js`)
- Auth controller → EJS pages: renders auth pages (evidence: `controllers/auth.js`)
- Posts controller → EJS pages: renders post pages (evidence: `controllers/posts.js`)
