ResumeIQ

Analyze. Optimize. Get Hired.

ResumeIQ is a modern ATS (Applicant Tracking System) resume analyzer that helps job seekers improve their resumes before applying for jobs. It provides detailed resume evaluations, ATS compatibility checks, keyword analysis, and personalized improvement suggestions powered by Google's Gemini AI—all through a simple and intuitive interface.

🌐 Live Demo

🚀 Try ResumeIQ here:

https://resume-iq-f5lx.onrender.com

Note: This application is hosted on Render's Free Plan. If the website has been inactive for a while, the first request may take 30–60 seconds to load while the server wakes up. After that, it runs normally.

---

✨ Features

• 📄 ATS Resume Analysis
• 🤖 AI-Powered Resume Feedback
• 🔍 Keyword & Skills Detection
• 📊 ATS Compatibility Score
• 📝 Actionable Resume Improvement Suggestions
• 📚 Resume Analysis History
• 👤 User Authentication
• ⚙️ Personal Dashboard
• 🎨 Modern & Responsive Interface

---

🛠️ Tech Stack

Frontend

• React
• TypeScript
• Vite
• CSS

Backend

• Node.js
• TypeScript

AI

• Google Gemini API

Deployment

• Render

---

🚀 Running Locally

Prerequisites

• Node.js 18+
• npm

Installation

Clone the repository:

git clone https://github.com/Ouissal-Hadji/ResumeIQ.git

Go into the project folder:

cd ResumeIQ

Install dependencies:

npm install

Start the development server:

npm run dev

Open your browser:

http://localhost:5173

Developer Note: The deployed version already includes the required backend configuration. End users do not need to provide a Gemini API key. An API key is only required if you are running your own local instance.

---

📁 Project Structure

ResumeIQ
│
├── src/
│   ├── components/
│   ├── assets/
│   ├── App.tsx
│   └── main.tsx
│
├── server.ts
├── package.json
├── vite.config.ts
└── README.md

---

🎯 What ResumeIQ Helps You Do

• Improve ATS compatibility before applying
• Discover missing keywords and skills
• Receive AI-generated resume recommendations
• Increase the chances of passing ATS filters
• Build a stronger, more professional resume

---

🤝 Contributing

Contributions, suggestions, and pull requests are always welcome.

If you find a bug or have an idea for a new feature, feel free to open an issue.

---

📄 License

This project is licensed under the MIT License.

---

👩‍💻 Developed by

Ouissal Hadji

Computer Science Student • Full Stack Developer • AI Enthusiast

GitHub: https://github.com/Ouissal-Hadji