# habibullah2007-dev/resume-forge architecture

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

- Interactive diagram: https://gitdiagram.com/habibullah2007-dev/resume-forge
- Repository: https://github.com/habibullah2007-dev/resume-forge

## Overview

ResumeForge is a web app for tailoring a resume to a job description. The workflow collects a resume and job details, extracts document text, analyzes gaps, requests tailored content, and exports a revised resume. Users can also sign in and access history. The excerpts show the routing, document extraction, AI request path, a review-page database insert, and PDF rendering; behavior in unsampled pages is represented by their modules without inferred connections.

Main entry points: [`src/App.tsx`](https://github.com/habibullah2007-dev/resume-forge/blob/main/src/App.tsx) (App routes), [`src/lib/supabase.ts`](https://github.com/habibullah2007-dev/resume-forge/blob/main/src/lib/supabase.ts) (Supabase client), [`src/contexts/AuthContext.tsx`](https://github.com/habibullah2007-dev/resume-forge/blob/main/src/contexts/AuthContext.tsx) (Auth context), [`src/pages/Review.tsx`](https://github.com/habibullah2007-dev/resume-forge/blob/main/src/pages/Review.tsx) (Tailor review)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Resume workflow"]
  node_app["App routes<br/>[App.tsx]"]
  node_layout["Workflow state<br/>[Layout.tsx]"]
  node_upload["Resume upload<br/>[Upload.tsx]"]
  node_extractor["Text extraction<br/>[extractor.ts]"]
  node_analyze["Gap analysis<br/>[Analyze.tsx]"]
  node_review["Tailor review<br/>[Review.tsx]"]
end

subgraph group_identity["Identity and history"]
  node_login["Login<br/>[Login.tsx]"]
  node_auth["Auth context<br/>[AuthContext.tsx]"]
  node_protected["Route protection<br/>[ProtectedRoute.tsx]"]
  node_history["Resume history<br/>[History.tsx]"]
end

subgraph group_ai["AI tailoring"]
  node_api["Analysis API<br/>[analyze.js]"]
  node_provider["AI provider manager<br/>[providerManager.js]"]
  node_llm{{"LLM provider"}}
end

subgraph group_storage["Persistence and exports"]
  node_export["Resume export<br/>[Export.tsx]"]
  node_pdfdoc["PDF document"]
  node_supabase["Supabase client<br/>[supabase.ts]"]
  node_db[("Analyzed resumes")]
end

node_user(("User"))

node_app -->|"routes to"| node_layout
node_app -->|"routes to"| node_upload
node_app -->|"routes to"| node_analyze
node_app -->|"routes to"| node_review
node_app -->|"routes to"| node_export
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_history
node_app -->|"wraps routes"| node_protected
node_layout -->|"reads session"| node_auth
node_upload -->|"extracts text"| node_extractor
node_review -->|"requests tailoring"| node_api
node_review -->|"inserts record"| node_supabase
node_supabase -.->|"writes record"| node_db
node_api -->|"delegates to"| node_provider
node_provider -->|"sends prompt"| node_llm
node_auth -->|"uses client"| node_supabase
node_login -->|"uses auth"| node_auth
node_protected -->|"checks session"| node_auth
node_export -->|"renders PDF"| node_pdfdoc
node_export -.->|"uses client"| node_supabase
node_history -.->|"uses client"| node_supabase
node_user -.->|"provides resume"| node_upload

click node_app "https://github.com/habibullah2007-dev/resume-forge/blob/main/src/App.tsx"
click node_layout "https://github.com/habibullah2007-dev/resume-forge/blob/main/src/components/Layout.tsx"
click node_upload "https://github.com/habibullah2007-dev/resume-forge/blob/main/src/pages/Upload.tsx"
click node_extractor "https://github.com/habibullah2007-dev/resume-forge/blob/main/src/utils/extractor.ts"
click node_analyze "https://github.com/habibullah2007-dev/resume-forge/blob/main/src/pages/Analyze.tsx"
click node_review "https://github.com/habibullah2007-dev/resume-forge/blob/main/src/pages/Review.tsx"
click node_export "https://github.com/habibullah2007-dev/resume-forge/blob/main/src/pages/Export.tsx"
click node_pdfdoc "https://github.com/habibullah2007-dev/resume-forge/blob/main/src/components/ResumePdfDocument.tsx"
click node_login "https://github.com/habibullah2007-dev/resume-forge/blob/main/src/pages/Login.tsx"
click node_auth "https://github.com/habibullah2007-dev/resume-forge/blob/main/src/contexts/AuthContext.tsx"
click node_protected "https://github.com/habibullah2007-dev/resume-forge/blob/main/src/components/ProtectedRoute.tsx"
click node_history "https://github.com/habibullah2007-dev/resume-forge/blob/main/src/pages/History.tsx"
click node_supabase "https://github.com/habibullah2007-dev/resume-forge/blob/main/src/lib/supabase.ts"
click node_db "https://github.com/habibullah2007-dev/resume-forge/blob/main/supabase/migrations/20260707000000_create_analyzed_resumes.sql"
click node_api "https://github.com/habibullah2007-dev/resume-forge/blob/main/api/analyze.js"
click node_provider "https://github.com/habibullah2007-dev/resume-forge/blob/main/api/providerManager.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_layout,node_upload,node_extractor,node_analyze,node_review,node_user toneBlue
class node_login,node_auth,node_protected,node_history toneAmber
class node_api,node_provider,node_llm toneMint
class node_export,node_pdfdoc,node_supabase,node_db toneRose
```

## Components

### Resume workflow

- [App routes](https://github.com/habibullah2007-dev/resume-forge/blob/main/src/App.tsx): `src/App.tsx`
- [Workflow state](https://github.com/habibullah2007-dev/resume-forge/blob/main/src/components/Layout.tsx): `src/components/Layout.tsx`
- [Resume upload](https://github.com/habibullah2007-dev/resume-forge/blob/main/src/pages/Upload.tsx): `src/pages/Upload.tsx`
- [Text extraction](https://github.com/habibullah2007-dev/resume-forge/blob/main/src/utils/extractor.ts): `src/utils/extractor.ts`
- [Gap analysis](https://github.com/habibullah2007-dev/resume-forge/blob/main/src/pages/Analyze.tsx): `src/pages/Analyze.tsx`
- [Tailor review](https://github.com/habibullah2007-dev/resume-forge/blob/main/src/pages/Review.tsx): `src/pages/Review.tsx`

### Identity and history

- [Login](https://github.com/habibullah2007-dev/resume-forge/blob/main/src/pages/Login.tsx): `src/pages/Login.tsx`
- [Auth context](https://github.com/habibullah2007-dev/resume-forge/blob/main/src/contexts/AuthContext.tsx): `src/contexts/AuthContext.tsx`
- [Route protection](https://github.com/habibullah2007-dev/resume-forge/blob/main/src/components/ProtectedRoute.tsx): `src/components/ProtectedRoute.tsx`
- [Resume history](https://github.com/habibullah2007-dev/resume-forge/blob/main/src/pages/History.tsx): `src/pages/History.tsx`

### AI tailoring

- [Analysis API](https://github.com/habibullah2007-dev/resume-forge/blob/main/api/analyze.js): `api/analyze.js`
- [AI provider manager](https://github.com/habibullah2007-dev/resume-forge/blob/main/api/providerManager.js): `api/providerManager.js`
- **LLM provider**

### Persistence and exports

- [Resume export](https://github.com/habibullah2007-dev/resume-forge/blob/main/src/pages/Export.tsx): `src/pages/Export.tsx`
- [PDF document](https://github.com/habibullah2007-dev/resume-forge/blob/main/src/components/ResumePdfDocument.tsx): `src/components/ResumePdfDocument.tsx`
- [Supabase client](https://github.com/habibullah2007-dev/resume-forge/blob/main/src/lib/supabase.ts): `src/lib/supabase.ts`
- [Analyzed resumes](https://github.com/habibullah2007-dev/resume-forge/blob/main/supabase/migrations/20260707000000_create_analyzed_resumes.sql): `supabase/migrations/20260707000000_create_analyzed_resumes.sql`

### Other components

- **User**

## Connections

- App routes → Workflow state: routes to (evidence: `src/App.tsx`)
- App routes → Resume upload: routes to (evidence: `src/App.tsx`)
- App routes → Gap analysis: routes to (evidence: `src/App.tsx`)
- App routes → Tailor review: routes to (evidence: `src/App.tsx`)
- App routes → Resume export: routes to (evidence: `src/App.tsx`)
- App routes → Login: routes to (evidence: `src/App.tsx`)
- App routes → Resume history: routes to (evidence: `src/App.tsx`)
- App routes → Route protection: wraps routes (evidence: `src/App.tsx`)
- Workflow state → Auth context: reads session (evidence: `src/components/Layout.tsx`)
- Resume upload → Text extraction: extracts text (evidence: `src/pages/Upload.tsx`)
- Tailor review → Analysis API: requests tailoring (evidence: `src/pages/Review.tsx`)
- Tailor review → Supabase client: inserts record (evidence: `src/pages/Review.tsx`)
- Supabase client → Analyzed resumes: writes record
- Analysis API → AI provider manager: delegates to (evidence: `api/analyze.js`)
- AI provider manager → LLM provider: sends prompt (evidence: `api/providerManager.js`)
- Auth context → Supabase client: uses client (evidence: `src/contexts/AuthContext.tsx`)
- Login → Auth context: uses auth (evidence: `src/pages/Login.tsx`)
- Route protection → Auth context: checks session (evidence: `src/components/ProtectedRoute.tsx`)
- Resume export → PDF document: renders PDF (evidence: `src/pages/Export.tsx`)
- Resume export → Supabase client: uses client (evidence: `src/pages/Export.tsx`)
- Resume history → Supabase client: uses client (evidence: `src/pages/History.tsx`)
- User → Resume upload: provides resume
