🧠 HireSync

Production-Ready Full Stack Gen AI Job Preparation Web App

HireSync is a production-ready, AI-powered job preparation platform built with the MERN Stack and Google Gemini API. Users upload their resume and a job description to receive a personalized interview report — complete with AI-generated technical & behavioral questions, skill gap analysis, and an ATS-optimized resume PDF.

Features • Architecture • API Endpoints • Setup • Tech Stack

---

🖥️ App Preview

---

✨ Features

Feature	Description
🔐 JWT Authentication	Secure login/register with token blacklisting on logout
📧 OTP Email Verification	Brevo (Sendinblue) SMTP-based email OTP before account activation
📄 Resume Upload & Parsing	Multer handles PDF uploads; Gemini AI parses resume content
🤖 AI Interview Report	Gemini generates technical & behavioral questions based on resume + JD
📊 Skill Gap Analysis	AI compares user profile against job description to surface missing skills
🧾 ATS Resume PDF	Puppeteer converts AI-generated HTML resume into downloadable PDF
🗂️ Report Management	View, retrieve, and delete past interview reports
🧩 4-Layer Frontend	UI → Service (Axios) → State (Context API) → Hooks

---

🏗 Project Architecture

---

Folder Structure

HireSync/
│
├── backend/ # Node.js + Express server
│ ├── src/
│ │ ├── app.js # Express app entry point
│ │ │
│ │ ├── config/
│ │ │ ├── database.config.js # MongoDB connection via Mongoose
│ │ │ └── email.config.js # Brevo SMTP configuration
│ │ │
│ │ ├── controllers/
│ │ │ ├── auth.controllers.js # Register, Login, Logout, OTP logic
│ │ │ └── generateInterviewReport.controllers.js # AI report + PDF generation
│ │ │
│ │ ├── middlewares/
│ │ │ ├── auth.middleware.js # JWT verification middleware
│ │ │ └── file.middleware.js # Multer PDF/DOCX upload middleware
│ │ │
│ │ ├── models/
│ │ │ ├── user.models.js # User schema & model
│ │ │ ├── otp.models.js # OTP schema (time-limited, single-use)
│ │ │ ├── blacklist.models.js # JWT token blacklist on logout
│ │ │ └── InterviewReport.models.js # Interview report schema (Zod-validated)
│ │ │
│ │ ├── routes/
│ │ │ ├── auth.routes.js # /api/auth/* endpoints
│ │ │ └── interview.routes.js # /api/interview/* endpoints
│ │ │
│ │ ├── services/
│ │ │ ├── ai.services.js # Google Gemini API integration
│ │ │ └── email.services.js # Brevo email delivery (OTP + welcome)
│ │ │
│ │ └── utils/
│ │ └── utils.js # Shared utility functions
│ │
│ └── .env.example
│
└── frontend/ # React.js + Vite client
├── public/
│ └── assets/
│ └── auth-illustration.png
│
├── src/
│ ├── App.jsx # Root component & route definitions
│ ├── main.jsx # Vite entry point
│ ├── style.scss # Global styles
│ │
│ ├── components/
│ │ └── LoadingState.jsx # Shared loading spinner component
│ │
│ ├── features/
│ │ ├── auth/ # Authentication feature
│ │ │ ├── auth.context.jsx # Auth global state (Context API)
│ │ │ ├── auth.form.scss # Shared auth form styles
│ │ │ ├── components/
│ │ │ │ ├── Button.jsx # Reusable button component
│ │ │ │ └── Protected.jsx # Protected route wrapper
│ │ │ ├── hooks/
│ │ │ │ └── useAuth.js # Auth hook (login, register, logout)
│ │ │ ├── pages/
│ │ │ │ ├── Login.jsx
│ │ │ │ └── Register.jsx
│ │ │ └── services/
│ │ │ └── auth.api.js # Axios calls for auth endpoints
│ │ │
│ │ └── interview/ # Interview & app pages feature
│ │ ├── interview.context.jsx # Interview global state (Context API)
│ │ ├── hooks/
│ │ │ └── useInterview.js # Interview data fetching hook
│ │ ├── pages/
│ │ │ ├── Landing.jsx # Public landing page
│ │ │ ├── Home.jsx # Dashboard (post-login)
│ │ │ ├── Interview.jsx # Report generation & display
│ │ │ ├── Help.jsx # FAQ / Help center
│ │ │ ├── Policy.jsx # Privacy policy
│ │ │ └── Terms.jsx # Terms of service
│ │ ├── services/
│ │ │ └── interview.api.js # Axios calls for interview endpoints
│ │ └── styles/
│ │ ├── Landing.scss
│ │ ├── Home.scss
│ │ ├── Interview.scss
│ │ ├── Help.scss
│ │ ├── Policy.scss
│ │ └── Terms.scss
│ │
│ ├── style/
│ │ └── Button.scss
│ │
│ └── utils/
│ └── parseResume.js # Client-side resume parsing utility
│
└── .env.example

---

📡 API Endpoints

Auth Routes — /api/auth

Method	Endpoint	Description	Auth Required
POST	/register	Register a new user	❌
POST	/verify-email	Verify email via OTP	❌
POST	/resend-otp	Resend OTP to email	❌
POST	/check-availability	Check username/email availability	❌
POST	/login	Login and receive JWT access token	❌
POST	/logout	Logout and blacklist token	✅
GET	/user	Get authenticated user details	✅

---

Interview Routes — /api/interview

Method	Endpoint	Description	Auth Required
POST	/	Upload resume + JD → Generate AI interview report	✅
GET	/reports	Get all interview reports for logged-in user	✅
GET	/report/:interviewId	Get a specific interview report by ID	✅
POST	/resume/pdf/:interviewReportId	Generate ATS-optimized resume PDF	✅
DELETE	/report/:interviewId	Delete an interview report	✅

---

Request & Response Examples

📮 POST /api/auth/register

Request Body:

{
"username": "johndoe",
"email": "john@example.com",
"password": "SecurePass@123"
}

Response 201:

{
"success": true,
"message": "User registered. Please verify your email via OTP."
}

Register page:

OTP email received in inbox:

After registration, a 6-digit OTP is sent to the user's email via Brevo SMTP for verification.

Welcome email after verification:

Once OTP is verified, a welcome email is automatically triggered.

---

🔓 POST /api/auth/login

Request Body:

{
"email": "john@example.com",
"password": "SecurePass@123"
}

Response 200:

{
"success": true,
"accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"user": {
"id": "64f1a2b3c4d5e6f7a8b9c0d1",
"username": "johndoe",
"email": "john@example.com"
}
}

Login page:

---

✅ POST /api/auth/verify-email

Request Body:

{
"email": "john@example.com",
"otp": "482910"
}

Response 200:

{
"success": true,
"message": "Email verified. Account is now active."
}

OTP verification page:

---

🤖 POST /api/interview — Generate Interview Report

Request:multipart/form-data

Field	Type	Description
resume	File (PDF)	User's resume in PDF format
jobDescription	string	Target job description text
jobTitle	string	Target job title

Response 201:

{
"success": true,
"interviewReport": {
"_id": "report_id_here",
"technicalQuestions": [...],
"behavioralQuestions": [...],
"skillGapAnalysis": {...},
"optimizedResume": "..."
}
}

Upload resume & job description:

AI-generated interview report:

Interview prep roadmap:

ATS-optimized resume PDF:

Once the report is generated, clicking "Download Resume" triggers a direct PDF download — an ATS-optimized, role-tailored resume built from your profile.

---

🚀 Getting Started

Prerequisites

• Node.js v18+
• MongoDB Atlas account (or local MongoDB)
• Google Gemini API Key
• Brevo (Sendinblue) account for SMTP email

---

1. Clone the Repository

git clone https://github.com/your-username/hiresync.git
cd hiresync

---

2. Backend Setup

cd backend
npm install
cp .env.example .env

Edit .env with your values:

# ServerPORT=5000TOGGLE_AUTO_CLOAKING=false# DatabaseMONGO_URI=mongodb+srv://<user>:<password>@cluster.mongodb.net/hiresync# AuthenticationJWT_SECRET=your_super_secret_jwt_key# Email (Brevo SMTP)BREVO_API_KEY=your_brevo_api_keySENDER_EMAIL=your_verified_sender@example.comSENDER_NAME=HireSync

Start the backend:

# Development
npm run dev
# Production
npm start

Backend runs at http://localhost:5000 🚀

---

3. Frontend Setup

cd frontend
npm install
cp .env.example .env

Edit .env:

VITE_BASE_URL=http://localhost:5000

Start the frontend:

npm run dev

Frontend runs at http://localhost:5173 ⚡

---

🔒 Security Highlights

• Passwords hashed with bcrypt — never stored in plaintext
• JWT Blacklisting on logout — tokens are invalidated server-side
• OTP Expiry — time-limited, single-use OTPs via Brevo SMTP
• Protected Routes — all sensitive endpoints require valid JWT via authUser middleware
• File Validation — Multer restricts uploads to PDF format only

---

🛠 Tech Stack

Backend

Technology	Purpose
Node.js + Express.js	Server & REST API
MongoDB + Mongoose	Database & ODM
JSON Web Tokens (JWT)	Stateless authentication with blacklisting
bcrypt	Password hashing
Multer	PDF resume file upload handling
Google Gemini API	Resume parsing, skill gap analysis, question generation
Puppeteer	HTML → ATS-optimized resume PDF generation
Brevo (SMTP)	OTP email delivery
Zod	Schema validation for AI-generated structured output
dotenv	Environment variable management

Frontend

Technology	Purpose
React.js + Vite	UI framework & fast build tool
React Router	Client-side routing & protected routes
Context API	Global state management
Axios	HTTP service layer
SCSS	Component-level styling

---

📁 Environment Variables Reference

Backend .env

Variable	Description	Example
PORT	Server port	5000
TOGGLE_AUTO_CLOAKING	Internal toggle	false
MONGO_URI	MongoDB connection string	mongodb+srv://...
JWT_SECRET	JWT signing secret	random_secret_key
BREVO_API_KEY	Brevo SMTP API key	xkeysib-...
SENDER_EMAIL	Verified sender email	noreply@hiresync.com
SENDER_NAME	Email sender display name	HireSync

Frontend .env

Variable	Description	Example
VITE_BASE_URL	Backend API base URL	http://localhost:5000

---

🤝 Contributing

Contributions are welcome! Please open an issue first to discuss what you'd like to change.

git checkout -b feature/your-feature-name
git commit -m "feat: add your feature"
git push origin feature/your-feature-name

---

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.

---

Made with ❤️ by harshhere905

⭐ Star this repo if you found it helpful! ⭐