📄 Smart Resume Builder with AI ATS Checker

---

Smart Resume Builder is a full-stack, production-ready web application that enables users to build professional resumes, check ATS compatibility using AI, and export polished PDFs instantly. It features a live preview builder, Gemini-powered resume scoring, JWT authentication, and a personal dashboard — all built with a modern tech stack and designed for a premium user experience. Deployed on Vercel.

---

📋 Table of Contents

1. Overview
2. Live Demo
3. Features
4. How It Works
5. Tech Stack
6. Project Structure
7. Getting Started
8. Environment Variables
9. API Reference
10. Deployment Guide
11. Contributing
12. License

---

🔍 Overview

Smart Resume Builder gives job seekers a complete edge. Users sign up, build their resume with a guided form and live side-by-side preview, save it to their personal dashboard, and then run it through an AI-powered ATS Checker that uses Google Gemini 2.5 Flash to return a score, strengths, weaknesses, and specific improvement recommendations. Resumes can be exported to print-ready multi-page PDFs at any time.

---

🌐 Live Demo

🚀 View the Live App on Vercel →

---

✨ Features

1. 📝 Interactive Resume Builder

• Guided multi-section form: Personal Info, Work Experience, Education, and Skills.
• Real-time live preview pane that updates as you type.
• Create new resumes or edit existing ones from your dashboard (/builder/:id).

2. 🤖 AI-Powered ATS Checker

• Upload an image/screenshot of any resume.
• Powered by Google Gemini 2.5 Flash API — analyzes layout, keywords, and formatting.
• Returns an ATS score (0–100) with color-coded rating: Excellent / Good / Needs Work.
• Detailed breakdown of Strengths, Weaknesses, and Recommendations.

3. 🖨️ Multi-Page PDF Export

• Export your finished resume as a high-quality PDF.
• Smart pagination via html2pdf.js — content never gets clipped across pages.

4. 🎨 Modern, Responsive UI

• Built with Tailwind CSS with glassmorphism card components.
• Full Dark Mode / Light Mode toggle powered by ThemeContext.
• Smooth animated transitions using Framer Motion.

5. 🔐 Secure Authentication

• Full JWT-based stateless auth (register → login → protected routes).
• Passwords hashed with bcryptjs.
• PrivateRoute guard redirects unauthenticated users to /login.
• Protected pages: Dashboard, Builder, ATS Checker.
• Public pages: Home, Login, Register, Help.

6. 🗂️ Personal Dashboard

• View all your saved resumes in one place.
• One-click edit or delete for any resume.
• Quick-launch button to jump into the Resume Builder.

7. 💬 Help Center

• Comprehensive guide covering AI Resume Building and ATS Checking workflows.
• Direct WhatsApp and Email support buttons for instant assistance.

---

⚙️ How It Works

User Registers / Logs In (JWT issued)
          │
          ▼
    Resume Builder  ──────────────────────────────┐
    (Form + Live Preview)                         │
          │                                       │
          ▼                                       ▼
  Save Resume to PostgreSQL DB       ATS Checker (Upload Image)
          │                                       │
          ▼                                       ▼
   Dashboard (Manage Resumes)    Gemini 2.5 Flash API → Score + Feedback
          │
          ▼
  Export Resume as PDF (html2pdf.js)

---

💻 Tech Stack

Frontend

Technology	Version	Purpose
React	18	UI Framework (via Vite)
Tailwind CSS	v3	Styling & Design System
Framer Motion	latest	Animations & Transitions
Lucide React	latest	Icon Library
html2pdf.js	latest	PDF Generation & Export
React Router DOM	v6	Client-Side Routing
Axios	latest	HTTP Client

Backend

Technology	Version	Purpose
Node.js	v18+	Runtime Environment
Express.js	4.x	Web Server & REST API
PostgreSQL (pg)	8.x	Database Connection Pool
Google GenAI SDK (@google/genai)	1.x	AI Gemini 2.5 Flash Resume Analysis
Multer	2.x	Multipart Image Upload
jsonwebtoken	9.x	JWT Authentication
bcryptjs	2.x	Password Hashing
Helmet	7.x	HTTP Security Headers
Morgan	1.x	HTTP Request Logging
dotenv	16.x	Environment Variable Loader

---

📂 Project Structure

📦 Smart-Resume-Builder/
├── 📁 backend/                    # Express.js API Server
│   ├── 📁 config/
│   │   └── 📄 db.js               # Supabase Client Initialization
│   ├── 📁 controllers/
│   │   ├── 📄 authController.js   # Register & Login logic
│   │   ├── 📄 resumeController.js # Resume CRUD operations
│   │   └── 📄 aiController.js     # OpenAI ATS analysis
│   ├── 📁 middleware/
│   │   └── 📄 authMiddleware.js   # JWT verification middleware
│   ├── 📁 models/                 # DB query helpers (User, Resume)
│   ├── 📁 routes/
│   │   ├── 📄 authRoutes.js       # POST /api/auth/register, /login
│   │   ├── 📄 resumeRoutes.js     # GET/POST/DELETE /api/resumes
│   │   └── 📄 aiRoutes.js         # POST /api/ai/analyze-ats-image
│   ├── 📄 schema.sql              # Supabase database schema
│   └── 📄 server.js               # Entry point (Express app setup)
│
├── 📁 frontend/                   # React 18 + Vite UI
│   ├── 📁 public/                 # Static assets
│   ├── 📁 src/
│   │   ├── 📁 components/
│   │   │   ├── 📄 Navbar.jsx      # Top navigation bar
│   │   │   └── 📄 ResumePreview.jsx # Live resume preview pane
│   │   ├── 📁 context/
│   │   │   ├── 📄 AuthContext.jsx # Global auth state & JWT storage
│   │   │   └── 📄 ThemeContext.jsx# Dark / Light mode toggle
│   │   ├── 📁 pages/
│   │   │   ├── 📄 Home.jsx        # Landing page (public)
│   │   │   ├── 📄 Login.jsx       # Login form (public)
│   │   │   ├── 📄 Register.jsx    # Registration form (public)
│   │   │   ├── 📄 Dashboard.jsx   # Saved resumes list (protected)
│   │   │   ├── 📄 Builder.jsx     # Resume form + live preview (protected)
│   │   │   ├── 📄 ATSChecker.jsx  # AI ATS score page (protected)
│   │   │   └── 📄 Help.jsx        # Help center (public)
│   │   ├── 📁 services/
│   │   │   └── 📄 api.js          # Axios instance with base URL & JWT header
│   │   ├── 📄 App.jsx             # Route definitions (PrivateRoute guard)
│   │   └── 📄 index.css           # Tailwind directives & custom layers
│   ├── 📄 vercel.json             # Vercel deployment & SPA rewrite config
│   └── 📄 vite.config.js          # Vite bundler settings
│
└── 📄 README.md

---

🚀 Getting Started

Prerequisites

• Node.js v18+ installed
• A Google Gemini API Key (get yours from Google AI Studio)
• A PostgreSQL database (local instance or cloud database from Neon, Supabase, etc.)

1. Clone the Repository

git clone https://github.com/your-username/smart-resume-builder.git
cd smart-resume-builder

2. Backend Setup

cd backend
npm install

Create a .env file in the backend/ folder (see Environment Variables), then:

npm start
# ✅ Server starts on http://localhost:8001
# ✅ PostgreSQL Database Connected Successfully

3. Frontend Setup

Open a new terminal:

cd frontend
npm install
npm run dev
# ✅ App starts on http://localhost:5173

Open your browser at http://localhost:5173 to use the app.

---

🔑 Environment Variables

Create a .env file in the backend/ directory:

# Server Port
PORT=8001

# Authentication — use a long, random secret string
JWT_SECRET=your_super_secret_jwt_key_here

# Gemini API Key — required for AI features
GEMINI_API_KEY=your_gemini_api_key_here

# PostgreSQL Database Connection URL
DATABASE_URL=postgresql://username:password@localhost:5432/database

⚠️ Never commit your .env file. Ensure it is listed in .gitignore.

---

📡 API Reference

All protected routes require the header:

x-auth-token: <your_jwt_token>

🔐 Auth — /api/auth

Method	Endpoint	Auth	Body	Description
POST	/api/auth/register	❌	{ name, email, password }	Register a new user
POST	/api/auth/login	❌	{ email, password }	Login, returns JWT token

📄 Resumes — /api/resumes

Method	Endpoint	Auth	Description
GET	/api/resumes	✅	Get all resumes for the logged-in user
POST	/api/resumes	✅	Save a new resume
GET	/api/resumes/:id	✅	Get a single resume by ID
PUT	/api/resumes/:id	✅	Update an existing resume
DELETE	/api/resumes/:id	✅	Delete a resume by ID

🤖 AI — /api/ai

Method	Endpoint	Auth	Body	Description
POST	/api/ai/suggestions	✅	{ resumeData }	Analyze resume text data and return 5-7 improvement suggestions
POST	/api/ai/ats-score	✅	{ resumeData, targetKeywords: [] }	Calculate ATS match score against keywords
POST	/api/ai/analyze-ats-image	✅	FormData: { resumeImage: File }	Analyze a resume screenshot/image for ATS score & feedback
POST	/api/ai/parse	✅	FormData: { resumeImage: File }	Extract structural JSON resume data from a resume image
POST	/api/ai/tailor	✅	{ resumeId, jobDescription, jobTitle, companyName }	Tailor resume for job and generate matching cover letter

Example /api/ai/analyze-ats-image Response:

{
  "score": 78,
  "summary": "A strong resume with good structure, but missing key technical keywords.",
  "feedback": {
    "strengths": ["Clean layout", "Quantified achievements"],
    "weaknesses": ["Missing technical skills section"],
    "recommendations": ["Add a Skills section with relevant technologies"]
  }
}

---

☁️ Deployment Guide

Frontend → Vercel

1. Push your project to a GitHub Repository.
2. Ensure node_modules is in .gitignore.
3. Go to vercel.com → Import your repository.
4. Set Root Directory to frontend.
5. Add the environment variable VITE_API_BASE_URL pointing to your deployed backend API URL (e.g. https://your-backend.onrender.com/api).
6. Vercel will auto-detect Vite and run npm run build.

Backend → Render / Railway

1. Deploy the backend/ folder as a Node.js Web Service.
2. Set all environment variables (PORT, JWT_SECRET, GEMINI_API_KEY, DATABASE_URL) in the dashboard.
3. Set the Start Command to: node server.js

---

🤝 Contributing

Contributions, issues, and feature requests are welcome!

1. Fork the repository
2. Create your branch: git checkout -b feature/my-feature
3. Commit your changes: git commit -m 'Add my feature'
4. Push to the branch: git push origin feature/my-feature
5. Open a Pull Request

---

"Your resume is not just a document — it's the blueprint of your professional journey. Build it with purpose, design it with care, and let it open the doors to your future."

Build your future today. 🚀