# utkarshgupta05/ai_resumebuilder architecture

> Architecture diagram of the GitHub repository utkarshgupta05/ai_resumebuilder, 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/utkarshgupta05/ai_resumebuilder
- Repository: https://github.com/utkarshgupta05/ai_resumebuilder

## Overview

ResumeForge AI is a resume-building product: users sign in, create or upload a resume, edit and preview it, and use template, AI-optimization, and ATS-scoring features. The repository contains a React client and an Express/MongoDB backend. The graph follows the documented client-to-API boundary and source-indexed backend routes; several feature-specific route/controller links and frontend page internals were not sampled, so those connections are omitted rather than inferred.

Main entry points: [`server/app.js`](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/app.js) (Express app and routing), [`src/pages`](https://github.com/utkarshgupta05/ai_resumebuilder/tree/main/src/pages) (Product pages), [`server/routes/authRoutes.js`](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/routes/authRoutes.js) (Authentication routes), [`server/controllers/authController.js`](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/controllers/authController.js) (Authentication handlers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client experience"]
  node_webapp["React app and routes<br/>[App.jsx]"]
  node_pages["Product pages"]
  node_builder["Resume editor and preview<br/>[ResumeBuilder.jsx]"]
  node_templates["Template gallery<br/>[Templates.jsx]"]
  node_aiui["AI optimizer<br/>[AIOptimizer.jsx]"]
  node_uploadui["Resume upload<br/>[UploadResume.jsx]"]
  node_ui["Shared UI components<br/>[Button.jsx]"]
end

subgraph group_state["Client state and API"]
  node_authstate["Authentication state<br/>[AuthContext.jsx]"]
  node_resumestate["Resume state<br/>[ResumeContext.jsx]"]
  node_api["HTTP client<br/>[api.js]"]
end

subgraph group_http["HTTP application"]
  node_appserver["Express app and routing<br/>[app.js]"]
  node_authroutes["Authentication routes<br/>[authRoutes.js]"]
  node_resumeroutes["Resume routes<br/>[resumeRoutes.js]"]
  node_airoutes["AI routes<br/>[aiRoutes.js]"]
  node_db[("MongoDB connection<br/>[db.js]")]
  node_error["Error handling<br/>[errorHandler.js]"]
end

subgraph group_identity["Identity and profiles"]
  node_authcontroller["Authentication handlers<br/>[authController.js]"]
  node_authmiddleware["Bearer authentication<br/>[auth.js]"]
  node_usercontroller["Profile handlers<br/>[userController.js]"]
  node_users[("User records<br/>[User.js]")]
  node_google["Google identity verification"]
end

subgraph group_resumes["Resume workflows"]
  node_resumecontroller["Resume handlers"]
  node_resumemodel[("Resume records<br/>[Resume.js]")]
  node_normalizer["Resume normalization"]
  node_parser["PDF and DOCX parsing"]
end

subgraph group_services["Analysis and integrations"]
  node_aicontroller["AI handlers<br/>[aiController.js]"]
  node_gemini["Gemini AI service<br/>[geminiService.js]"]
  node_ats["ATS scoring engine<br/>[atsService.js]"]
  node_cloudinary["Cloudinary uploads"]
  node_templatesvc["Template handlers"]
end

node_user(("ResumeForge user"))

node_user -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_pages
node_pages -.->|"renders"| node_ui
node_pages -.->|"uses auth"| node_authstate
node_builder -.->|"edits resumes"| node_resumestate
node_authstate -->|"calls"| node_api
node_resumestate -->|"calls"| node_api
node_api -->|"sends requests"| node_appserver
node_appserver -->|"mounts"| node_authroutes
node_appserver -->|"mounts"| node_resumeroutes
node_appserver -->|"mounts"| node_airoutes
node_authroutes -->|"dispatches"| node_authcontroller
node_resumeroutes -->|"dispatches"| node_resumecontroller
node_airoutes -->|"dispatches"| node_aicontroller
node_authroutes -->|"guards routes"| node_authmiddleware
node_authcontroller -->|"reads and writes"| node_users
node_authcontroller -->|"verifies identity"| node_google
node_usercontroller -->|"reads and writes"| node_users
node_authmiddleware -->|"loads user"| node_users
node_resumecontroller -->|"reads and writes"| node_resumemodel
node_resumecontroller -->|"normalizes sections"| node_normalizer
node_uploadui -.->|"uploads resume"| node_parser
node_aicontroller -->|"calls"| node_gemini
node_templates -.->|"loads templates"| node_templatesvc
node_appserver -->|"checks connection"| node_db
node_builder -.->|"persists via API"| node_resumemodel
node_aiui -.->|"uses scoring"| node_ats
node_uploadui -.->|"profile image uploads"| node_cloudinary
node_appserver -->|"handles errors"| node_error

click node_webapp "https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/src/App.jsx"
click node_pages "https://github.com/utkarshgupta05/ai_resumebuilder/tree/main/src/pages"
click node_builder "https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/src/pages/ResumeBuilder.jsx"
click node_templates "https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/src/pages/Templates.jsx"
click node_aiui "https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/src/pages/AIOptimizer.jsx"
click node_uploadui "https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/src/pages/UploadResume.jsx"
click node_ui "https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/src/components/ui/Button.jsx"
click node_authstate "https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/src/context/AuthContext.jsx"
click node_resumestate "https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/src/context/ResumeContext.jsx"
click node_api "https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/src/services/api.js"
click node_appserver "https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/app.js"
click node_authroutes "https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/routes/authRoutes.js"
click node_resumeroutes "https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/routes/resumeRoutes.js"
click node_airoutes "https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/routes/aiRoutes.js"
click node_authcontroller "https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/controllers/authController.js"
click node_authmiddleware "https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/middleware/auth.js"
click node_usercontroller "https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/controllers/userController.js"
click node_users "https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/models/User.js"
click node_google "https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/services/googleAuthService.js"
click node_resumecontroller "https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/controllers/resumeController.js"
click node_resumemodel "https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/models/Resume.js"
click node_normalizer "https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/services/resumeNormalizer.js"
click node_parser "https://github.com/utkarshgupta05/ai_resumebuilder/tree/main/server/services/parser"
click node_aicontroller "https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/controllers/aiController.js"
click node_gemini "https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/services/geminiService.js"
click node_ats "https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/services/atsService.js"
click node_cloudinary "https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/services/cloudinaryService.js"
click node_templatesvc "https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/controllers/templateController.js"
click node_db "https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/config/db.js"
click node_error "https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/middleware/errorHandler.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_webapp,node_pages,node_builder,node_templates,node_aiui,node_uploadui,node_ui,node_user toneBlue
class node_authstate,node_resumestate,node_api toneAmber
class node_appserver,node_authroutes,node_resumeroutes,node_airoutes,node_db,node_error toneMint
class node_authcontroller,node_authmiddleware,node_usercontroller,node_users,node_google toneRose
class node_resumecontroller,node_resumemodel,node_normalizer,node_parser toneIndigo
class node_aicontroller,node_gemini,node_ats,node_cloudinary,node_templatesvc toneTeal
```

## Components

### Client experience

- [React app and routes](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/src/App.jsx): `src/App.jsx`
- [Product pages](https://github.com/utkarshgupta05/ai_resumebuilder/tree/main/src/pages): `src/pages`
- [Resume editor and preview](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/src/pages/ResumeBuilder.jsx): `src/pages/ResumeBuilder.jsx`
- [Template gallery](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/src/pages/Templates.jsx): `src/pages/Templates.jsx`
- [AI optimizer](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/src/pages/AIOptimizer.jsx): `src/pages/AIOptimizer.jsx`
- [Resume upload](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/src/pages/UploadResume.jsx): `src/pages/UploadResume.jsx`
- [Shared UI components](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/src/components/ui/Button.jsx): `src/components/ui/Button.jsx`

### Client state and API

- [Authentication state](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/src/context/AuthContext.jsx): `src/context/AuthContext.jsx`
- [Resume state](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/src/context/ResumeContext.jsx): `src/context/ResumeContext.jsx`
- [HTTP client](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/src/services/api.js): `src/services/api.js`

### HTTP application

- [Express app and routing](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/app.js): `server/app.js`
- [Authentication routes](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/routes/authRoutes.js): `server/routes/authRoutes.js`
- [Resume routes](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/routes/resumeRoutes.js): `server/routes/resumeRoutes.js`
- [AI routes](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/routes/aiRoutes.js): `server/routes/aiRoutes.js`
- [MongoDB connection](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/config/db.js): `server/config/db.js`
- [Error handling](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/middleware/errorHandler.js): `server/middleware/errorHandler.js`

### Identity and profiles

- [Authentication handlers](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/controllers/authController.js): `server/controllers/authController.js`
- [Bearer authentication](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/middleware/auth.js): `server/middleware/auth.js`
- [Profile handlers](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/controllers/userController.js): `server/controllers/userController.js`
- [User records](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/models/User.js): `server/models/User.js`
- [Google identity verification](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/services/googleAuthService.js): `server/services/googleAuthService.js`

### Resume workflows

- [Resume handlers](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/controllers/resumeController.js): `server/controllers/resumeController.js`
- [Resume records](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/models/Resume.js): `server/models/Resume.js`
- [Resume normalization](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/services/resumeNormalizer.js): `server/services/resumeNormalizer.js`
- [PDF and DOCX parsing](https://github.com/utkarshgupta05/ai_resumebuilder/tree/main/server/services/parser): `server/services/parser`

### Analysis and integrations

- [AI handlers](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/controllers/aiController.js): `server/controllers/aiController.js`
- [Gemini AI service](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/services/geminiService.js): `server/services/geminiService.js`
- [ATS scoring engine](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/services/atsService.js): `server/services/atsService.js`
- [Cloudinary uploads](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/services/cloudinaryService.js): `server/services/cloudinaryService.js`
- [Template handlers](https://github.com/utkarshgupta05/ai_resumebuilder/blob/main/server/controllers/templateController.js): `server/controllers/templateController.js`

### Other components

- **ResumeForge user**

## Connections

- ResumeForge user → React app and routes: uses
- React app and routes → Product pages: routes to (evidence: `src/App.jsx`)
- Product pages → Shared UI components: renders (evidence: `src/pages/ResumePreview.jsx`)
- Product pages → Authentication state: uses auth
- Resume editor and preview → Resume state: edits resumes
- Authentication state → HTTP client: calls (evidence: `src/context/AuthContext.jsx`)
- Resume state → HTTP client: calls (evidence: `src/context/ResumeContext.jsx`)
- HTTP client → Express app and routing: sends requests
- Express app and routing → Authentication routes: mounts (evidence: `server/app.js`)
- Express app and routing → Resume routes: mounts (evidence: `server/app.js`)
- Express app and routing → AI routes: mounts (evidence: `server/app.js`)
- Authentication routes → Authentication handlers: dispatches (evidence: `server/routes/authRoutes.js`)
- Resume routes → Resume handlers: dispatches (evidence: `server/routes/resumeRoutes.js`)
- AI routes → AI handlers: dispatches (evidence: `server/routes/aiRoutes.js`)
- Authentication routes → Bearer authentication: guards routes (evidence: `server/routes/authRoutes.js`)
- Authentication handlers → User records: reads and writes (evidence: `server/controllers/authController.js`)
- Authentication handlers → Google identity verification: verifies identity (evidence: `server/controllers/authController.js`)
- Profile handlers → User records: reads and writes (evidence: `server/controllers/userController.js`)
- Bearer authentication → User records: loads user (evidence: `server/middleware/auth.js`)
- Resume handlers → Resume records: reads and writes (evidence: `server/controllers/resumeController.js`)
- Resume handlers → Resume normalization: normalizes sections (evidence: `server/controllers/resumeController.js`)
- Resume upload → PDF and DOCX parsing: uploads resume
- AI handlers → Gemini AI service: calls (evidence: `server/controllers/aiController.js`)
- Template gallery → Template handlers: loads templates
- Express app and routing → MongoDB connection: checks connection (evidence: `server/app.js`)
- Resume editor and preview → Resume records: persists via API
- AI optimizer → ATS scoring engine: uses scoring
- Resume upload → Cloudinary uploads: profile image uploads
- Express app and routing → Error handling: handles errors (evidence: `server/app.js`)
