# vikranth-tej/resume-builder architecture

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

- Interactive diagram: https://gitdiagram.com/vikranth-tej/resume-builder
- Repository: https://github.com/vikranth-tej/resume-builder

## Overview

This is an AI-assisted resume builder: users create or upload a resume, edit its sections with AI help, save drafts, and export a PDF. The React client routes users among the landing page, dashboard, and editor; its API client communicates with an Express server that exposes authentication, resume, and AI endpoints. Resume and user data use MongoDB models. The excerpts show resume CRUD, PDF parsing, summary/text generation, and PDF export. Other README-listed capabilities, including Google OAuth and job-description scoring, are not confirmed in the sampled implementation.

Main entry points: [`server/index.js`](https://github.com/vikranth-tej/resume-builder/blob/main/server/index.js) (Express API), [`client/src/App.jsx`](https://github.com/vikranth-tej/resume-builder/blob/main/client/src/App.jsx) (Client routing), [`client/src/pages/Editor.jsx`](https://github.com/vikranth-tej/resume-builder/blob/main/client/src/pages/Editor.jsx) (Resume editor), [`server/routes/authRoutes.js`](https://github.com/vikranth-tej/resume-builder/blob/main/server/routes/authRoutes.js) (Authentication routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Resume workspace"]
  node_routing["Client routing<br/>[App.jsx]"]
  node_home["Landing page<br/>[Home.jsx]"]
  node_dashboard["Resume dashboard<br/>[Dashboard.jsx]"]
  node_editor["Resume editor<br/>[Editor.jsx]"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_server["API services"]
  node_api_server["Express API<br/>[index.js]"]
  node_auth_routes["Authentication routes<br/>[authRoutes.js]"]
  node_auth_middleware["JWT protection<br/>[authMiddleware.js]"]
  node_resume_routes["Resume endpoints<br/>[resumeRoutes.js]"]
  node_ai_routes["AI endpoints<br/>[aiRoutes.js]"]
end

subgraph group_data["Persistence"]
  node_user_model["User model<br/>[User.js]"]
  node_resume_model["Resume model<br/>[Resume.js]"]
  node_db_connector["Database connector<br/>[db.js]"]
end

subgraph group_integrations["External services"]
  node_mongo[("MongoDB")]
  node_gemini["Gemini API"]
  node_pdf_tool["PDF export"]
end

node_user(("Job seeker"))

node_user -->|"uses"| node_routing
node_routing -->|"routes to"| node_home
node_routing -->|"routes to"| node_dashboard
node_routing -->|"routes to"| node_editor
node_dashboard -->|"requests resumes"| node_api_client
node_editor -->|"loads and saves"| node_api_client
node_editor -->|"exports PDF"| node_pdf_tool
node_api_client -.->|"sends API requests"| node_api_server
node_api_server -->|"mounts routes"| node_auth_routes
node_api_server -->|"mounts routes"| node_resume_routes
node_api_server -->|"mounts routes"| node_ai_routes
node_auth_routes -->|"protects profile"| node_auth_middleware
node_auth_routes -->|"reads and creates"| node_user_model
node_auth_middleware -->|"loads user"| node_user_model
node_resume_routes -->|"reads and writes"| node_resume_model
node_db_connector -->|"connects"| node_mongo
node_api_server -->|"connects on startup"| node_db_connector
node_ai_routes -->|"generates text"| node_gemini
node_resume_routes -->|"structures uploads"| node_gemini

click node_routing "https://github.com/vikranth-tej/resume-builder/blob/main/client/src/App.jsx"
click node_home "https://github.com/vikranth-tej/resume-builder/blob/main/client/src/pages/Home.jsx"
click node_dashboard "https://github.com/vikranth-tej/resume-builder/blob/main/client/src/pages/Dashboard.jsx"
click node_editor "https://github.com/vikranth-tej/resume-builder/blob/main/client/src/pages/Editor.jsx"
click node_api_client "https://github.com/vikranth-tej/resume-builder/blob/main/client/src/api.js"
click node_api_server "https://github.com/vikranth-tej/resume-builder/blob/main/server/index.js"
click node_auth_routes "https://github.com/vikranth-tej/resume-builder/blob/main/server/routes/authRoutes.js"
click node_auth_middleware "https://github.com/vikranth-tej/resume-builder/blob/main/server/middleware/authMiddleware.js"
click node_resume_routes "https://github.com/vikranth-tej/resume-builder/blob/main/server/routes/resumeRoutes.js"
click node_ai_routes "https://github.com/vikranth-tej/resume-builder/blob/main/server/routes/aiRoutes.js"
click node_user_model "https://github.com/vikranth-tej/resume-builder/blob/main/server/models/User.js"
click node_resume_model "https://github.com/vikranth-tej/resume-builder/blob/main/server/models/Resume.js"
click node_db_connector "https://github.com/vikranth-tej/resume-builder/blob/main/server/config/db.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_routing,node_home,node_dashboard,node_editor,node_api_client toneBlue
class node_api_server,node_auth_routes,node_auth_middleware,node_resume_routes,node_ai_routes toneAmber
class node_user_model,node_resume_model,node_db_connector toneMint
class node_mongo,node_gemini,node_pdf_tool toneRose
class node_user toneIndigo
```

## Components

### Resume workspace

- [Client routing](https://github.com/vikranth-tej/resume-builder/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Landing page](https://github.com/vikranth-tej/resume-builder/blob/main/client/src/pages/Home.jsx): `client/src/pages/Home.jsx`
- [Resume dashboard](https://github.com/vikranth-tej/resume-builder/blob/main/client/src/pages/Dashboard.jsx): `client/src/pages/Dashboard.jsx`
- [Resume editor](https://github.com/vikranth-tej/resume-builder/blob/main/client/src/pages/Editor.jsx): `client/src/pages/Editor.jsx`
- [API client](https://github.com/vikranth-tej/resume-builder/blob/main/client/src/api.js): `client/src/api.js`

### API services

- [Express API](https://github.com/vikranth-tej/resume-builder/blob/main/server/index.js): `server/index.js`
- [Authentication routes](https://github.com/vikranth-tej/resume-builder/blob/main/server/routes/authRoutes.js): `server/routes/authRoutes.js`
- [JWT protection](https://github.com/vikranth-tej/resume-builder/blob/main/server/middleware/authMiddleware.js): `server/middleware/authMiddleware.js`
- [Resume endpoints](https://github.com/vikranth-tej/resume-builder/blob/main/server/routes/resumeRoutes.js): `server/routes/resumeRoutes.js`
- [AI endpoints](https://github.com/vikranth-tej/resume-builder/blob/main/server/routes/aiRoutes.js): `server/routes/aiRoutes.js`

### Persistence

- [User model](https://github.com/vikranth-tej/resume-builder/blob/main/server/models/User.js): `server/models/User.js`
- [Resume model](https://github.com/vikranth-tej/resume-builder/blob/main/server/models/Resume.js): `server/models/Resume.js`
- [Database connector](https://github.com/vikranth-tej/resume-builder/blob/main/server/config/db.js): `server/config/db.js`

### External services

- **MongoDB**
- **Gemini API**
- **PDF export**

### Other components

- **Job seeker**

## Connections

- Job seeker → Client routing: uses (evidence: `client/src/App.jsx`)
- Client routing → Landing page: routes to (evidence: `client/src/App.jsx`)
- Client routing → Resume dashboard: routes to (evidence: `client/src/App.jsx`)
- Client routing → Resume editor: routes to (evidence: `client/src/App.jsx`)
- Resume dashboard → API client: requests resumes (evidence: `client/src/pages/Dashboard.jsx`)
- Resume editor → API client: loads and saves (evidence: `client/src/pages/Editor.jsx`)
- Resume editor → PDF export: exports PDF (evidence: `client/src/pages/Editor.jsx`)
- API client → Express API: sends API requests (evidence: `README.md`)
- Express API → Authentication routes: mounts routes (evidence: `server/index.js`)
- Express API → Resume endpoints: mounts routes (evidence: `server/index.js`)
- Express API → AI endpoints: mounts routes (evidence: `server/index.js`)
- Authentication routes → JWT protection: protects profile (evidence: `server/routes/authRoutes.js`)
- Authentication routes → User model: reads and creates (evidence: `server/routes/authRoutes.js`)
- JWT protection → User model: loads user (evidence: `server/middleware/authMiddleware.js`)
- Resume endpoints → Resume model: reads and writes (evidence: `server/routes/resumeRoutes.js`)
- Database connector → MongoDB: connects (evidence: `server/config/db.js`)
- Express API → Database connector: connects on startup (evidence: `server/index.js`)
- AI endpoints → Gemini API: generates text (evidence: `server/routes/aiRoutes.js`)
- Resume endpoints → Gemini API: structures uploads (evidence: `server/routes/resumeRoutes.js`)
