🏆 ResumeYouNeed

# 🏆 ResumeYouNeed  
###  TechSprint Hackathon Submission 



🚀 *Live Demo: https://resume-youneedanandjha.vercel.app/


📦 *GitHub Repository: https://github.com/2006anand/ResumeYouNeed

 🚀 Live MVP Demo

👉 https://resume-youneed-anandjha.vercel.app/

🎬 Solution Explanation Video Link:
👉 https://drive.google.com/file/d/13nbh2dhRNP1tqGR8uHfyUTXz8kqwbXNk/view?usp=sharing


---

## 👥 Team Details

*Team Name:* TEAM BYTE BREAKER  
*Team Leader:* Anand Kumar Jha  

---

## 👥 Team BYTE BREAKER

<div align="center">

| Role | Name | Contribution |
|:----:|:----:|:------------:|
| 🎯 **Team Leader** | **Anand Kumar Jha** | Architecture, AI Integration, Backend Logic |
| 💻 **Developer** | Aditya Singh | Frontend Components, State Management |
| 🎨 **Designer** | Debashrita Mandal | UI/UX Design, Styling |
| 📊 **Analyst** | Aaryan Lal Das | Data Visualization, Charts |

</div>



---


---

## 🏆 Why ResumeYouNeed Wins

> **"Most platforms solve one problem. We solve the entire hiring journey."**

| **Differentiator** | **Our Approach** |
|-------------------|------------------|
| **🎯 Completeness** | End-to-end solution for job seekers AND recruiters |
| **🧠 AI Intelligence** | Gemini-powered insights, not just templates |
| **📊 Data-Driven** | Real ATS scoring, skill gap analysis, comparative metrics |
| **🚀 Production-Ready** | Fully functional, zero hardcoded data, deployed & accessible |
| **🎨 UX Excellence** | Intuitive interface that judges can navigate in 60 seconds |

---


## 🧩 The Problem We're Solving

### For Job Seekers 👨‍💼
- **80% of resumes** are rejected by ATS before human review
- **No clarity** on why applications fail
- **Skill gaps** remain invisible until interview stage
- **Generic resumes** fail to match job descriptions

### For Recruiters 🏢
- **Manual screening** of 100+ applications per role
- **Bias in candidate comparison** without data
- **Time wasted** on unqualified candidates

  ---

### Our Solution: One Platform, Complete Journey ✅

**ResumeYouNeed** bridges the gap between job seekers and recruiters by providing:
- Smart AI-powered resume generation with STAR methodology
- Intelligent job matching with ATS compatibility scoring
- Data-driven candidate comparison tools
- Interview preparation with AI-generated Q&A

---

## 🌟 Key Features

### 1️⃣ **AI Smart Resume Builder**

**What It Does:**
- ✨ STAR-Method Bullet Generation
- 📄 ATS-Optimized A4 Layout
- 👁️ Live Preview (Print-Ready)
- 🧹 Intelligent Section Management

**Demo Flow:**
1. Enter basic info (name, contact, skills)
2. Add experience with AI-generated STAR bullets
3. Download professional PDF in 1 click

**Judge Test:** Try creating a resume in under 60 seconds

---

### 2️⃣ **Intelligent Job Matcher**

**What It Does:**
- 🎯 ATS Compatibility Score (0-100%)
- 🔍 Skill Gap Identification
- 💡 AI Interview Prep (Q&A)
- 📊 Visual Score Breakdown

**What Makes It Smart:**
- Analyzes resume vs job description semantically (not just keyword matching)
- Highlights missing skills with severity levels
- Generates role-specific interview questions based on gaps

**Judge Test:** Upload a resume + job description → Get instant match score

---

### 3️⃣ **AI Candidate Comparator**

**What It Does:**
- ⚖️ Side-by-Side Analysis
- 📈 Radar Chart Visualization
- 🤖 AI-Powered Tie-Breaker
- 🎓 Skill/Experience/Impact Metrics

**Real-World Use Case:**

Recruiter has 2 equally qualified candidates. Our AI analyzes their fit for the specific job description and recommends the better match.

**Judge Test:** Compare two sample candidates → See AI recommendation

---

## 🎥 Live Demo

### 🔗 **[Try ResumeYouNeed Now](https://resume-youneedanandjha.vercel.app/)**

**Judges Walkthrough :**
1. **Resume Builder** - Create a professional resume
2. **Job Matcher** - Check ATS compatibility score
3. **Candidate Comparator** - Compare two candidates side-by-side

---

## ⚙️ Tech Stack

<div align="center">

| Layer | Technology | Why We Chose It |
|:-----:|:----------:|:----------------|
| **Frontend** | React 19 + Vite | Lightning-fast dev experience, latest features |
| **Language** | TypeScript (96%) | Type safety for production-grade code |
| **Styling** | Tailwind CSS | Rapid UI development, consistent design |
| **Charts** | Recharts | Interactive, responsive data visualization |
| **Icons** | Lucide React | Modern, customizable icon set |
| **AI Engine** | Google Gemini Flash | Cutting-edge reasoning & context understanding |
| **PDF Export** | html2pdf.js | Client-side PDF generation (no backend needed) |
| **Deployment** | Vercel | Zero-config, edge-optimized hosting |

</div>

### Architecture Diagram

```
┌─────────────────────────────────────────────┐
│          User Interface (React)             │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐    │
│  │ Resume  │  │  Job    │  │Candidate│    │
│  │ Builder │  │ Matcher │  │Comparer │    │
│  └────┬────┘  └────┬────┘  └────┬────┘    │
└───────┼────────────┼────────────┼──

... (truncated)