Skip to content
Rajan-vishPublic

About

AI-Powered Resume Builder platform with OpenAI ATS bullet generation, real-time live preview, Redux state management, and ImageKit storage.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

4 Commits

Folders and files

Repository files navigation

📄 AI Resume Builder Platform

An end-to-end full-stack web application that empowers job seekers to build, customize, and export ATS-optimized professional resumes in minutes with AI-assisted content enhancement.

Live Demo React Express MongoDB OpenAI ImageKit

🌐 Live Application: https://resume-phi-teal-98.vercel.app


🌟 Key Highlights & Engineering Features

  • 🤖 AI Content Generation: Integrates the OpenAI API to craft professional executive summaries, action-oriented bullet points, and industry-tailored skill recommendations.
  • ⚡ Dynamic Live Preview: Instant visual feedback as users edit sections using centralized Redux Toolkit state management.
  • 🔐 Secure Authentication & Session Management: Built with Express.js, JWT tokens, and bcrypt password hashing.
  • 🖼️ Cloud Media Optimization: Uses ImageKit CDN for optimized avatar and profile photo upload and delivery.
  • 📱 Modern Responsive UI: Built with Vite, Tailwind CSS, and Lucide icons, ensuring seamless mobile and desktop experience.
  • 🖨️ Print & PDF Export: Formats resumes according to standard ATS single-page guidelines for clean PDF generation.

🏛️ System Architecture

┌────────────────────────────────────────────────────────┐
│             Frontend Client (React + Vite)             │
│  • Redux Toolkit State   • Tailwind CSS Styling        │
│  • Real-time Live Preview• Form Multi-Step Wizard      │
└───────────────────────────┬────────────────────────────┘
                            │ REST / JSON (Axios)
                            ▼
┌────────────────────────────────────────────────────────┐
│           Backend API Server (Express.js 5)            │
│  • JWT Authentication Middleware                       │
│  • Resume CRUD Controllers                             │
│  • AI Prompt Engineering & OpenAI Client               │
└───────────────┬───────────────────┬────────────────────┘
                │                   │
    ┌───────────▼────────┐ ┌────────▼───────────┐ ┌─────────────────────┐
    │   MongoDB Database │ │ OpenAI API Engine  │ │  ImageKit Cloud CDN │
    │ (Users & Resumes)  │ │ (Summary & Bullets)│ │ (Profile Pictures)  │
    └────────────────────┘ └────────────────────┘ └─────────────────────┘

🛠️ Tech Stack

Layer Technology Details
Frontend React 18, Vite Component-driven UI with lightning-fast HMR
State Management Redux Toolkit (@reduxjs/toolkit) Predictable, centralized resume data store
Styling Tailwind CSS, Lucide React Clean typography, flexible ATS layout
Backend Runtime Node.js, Express.js (v5) Modular MVC structure with middleware pipelines
Database MongoDB, Mongoose (v8) Schema-validated NoSQL persistence
AI Integration OpenAI SDK (openai) Structured prompt pipelines for resume optimization
File / Media Storage ImageKit Node SDK, Multer Secure multipart upload and thumbnail generation
Authentication JSON Web Tokens (JWT), Bcrypt Stateless authentication with signed tokens
Deployment Vercel (Client & API / Render) Production cloud continuous delivery

🚀 Getting Started

Prerequisites

  • Node.js (v18+)
  • MongoDB Atlas cluster or local MongoDB instance
  • OpenAI API Key
  • ImageKit Account credentials

1. Clone the Repository

git clone https://github.com/Rajan-vish/resume.git
cd resume

2. Backend Setup

cd server
npm install

Create a .env file in the server directory:

PORT=5000
MONGODB_URI=your_mongodb_connection_string
JWT_SECRET=your_jwt_secret_key
OPENAI_API_KEY=your_openai_api_key

# ImageKit Configuration
IMAGEKIT_PUBLIC_KEY=your_imagekit_public_key
IMAGEKIT_PRIVATE_KEY=your_imagekit_private_key
IMAGEKIT_URL_ENDPOINT=your_imagekit_url_endpoint

# Client Origin
CLIENT_URL=http://localhost:5173

Start the backend:

npm run server    # Runs with nodemon for development

3. Frontend Setup

In a new terminal window:

cd ../client
npm install

Create a .env file in the client directory:

VITE_API_URL=http://localhost:5000/api

Start the frontend development server:

npm run dev

Visit http://localhost:5173 in your browser.


📡 Core API Endpoints

Method Endpoint Description Protected
POST /api/auth/register Register new user account ❌
POST /api/auth/login Authenticate user & return JWT token ❌
GET /api/resumes Fetch all resumes for authenticated user ✅
POST /api/resumes Create a new resume record ✅
GET /api/resumes/:id Fetch detailed resume data by ID ✅
PUT /api/resumes/:id Update resume sections & layout ✅
DELETE /api/resumes/:id Delete resume ✅
POST /api/ai/enhance Generate AI-enhanced summaries & bullets ✅
POST /api/upload Upload profile image via Multer & ImageKit ✅

📁 Repository Structure

resume/
├── client/                     # Frontend Application
│   ├── src/
│   │   ├── app/                # Redux store configuration
│   │   ├── components/         # Reusable UI widgets & resume templates
│   │   ├── configs/            # API & environment helpers
│   │   ├── pages/              # Route views (Home, Login, Dashboard, ResumeBuilder, Preview)
│   │   ├── App.jsx             # Top-level routing
│   │   └── main.jsx            # React root mount
│   ├── package.json
│   └── vite.config.js
├── server/                     # Backend API Microservice
│   ├── configs/                # DB & 3rd-party clients (Mongoose, ImageKit, OpenAI)
│   ├── controllers/            # Request handlers (auth, resume, ai, upload)
│   ├── middlewares/            # JWT verification & Multer upload interceptors
│   ├── models/                 # Mongoose schemas (User, Resume)
│   ├── routes/                 # Express routing manifests
│   ├── package.json
│   └── server.js               # Entry point
├── render.yaml                 # Backend deployment manifest
├── vercel.json                 # Frontend deployment configuration
└── README.md                   # Project documentation

👨‍💻 Author

Rajan Kumar Vishwakarma

About

AI-Powered Resume Builder platform with OpenAI ATS bullet generation, real-time live preview, Redux state management, and ImageKit storage.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages