This is a minimalistic, responsive web application built using Next.js, Convex, Firebase, Clerk, and Google Generative AI. The main purpose of this project is to provide a seamless and intuitive experience for job seekers and recruiters to analyze resumes (CVs) based on job descriptions. The app is designed to analyze ATS (Applicant Tracking System) scores and offer detailed feedback and suggestions for job seekers.
I built this project to solve a common problem, which i encountered while searching for a job. Many ATS-checking websites lack good UI and user experience, with many built using frameworks like Streamlit and Python. I wanted to create a clean, intuitive platform with great user experience where users can check their ATS score and improve their resumes.
The app allows users to sign up or log in and choose between two roles: Recruiter or Job Seeker. The Recruiter role allows you to view resumes/CVs submitted by job seekers, filter them by skills, and access them via PDF links. The Job Seeker role allows users to upload their resume (CV), input a job description, and analyze their resume using generative AI to get tips, suggestions, and an ATS score.
- 🔐 User Authentication: Login or sign up using Clerk (Firebase Authentication alternative).
- 🧑💼👩💻 Role Selection: After logging in, users can choose whether they are a Recruiter or a Job Seeker.
- Recruiters can view job seekers' resumes and filter by skills.
- Job Seekers can upload their resume and analyze it against a job description.
- 🤖 AI-Powered Analysis: Resume analysis is powered by Google Generative AI, OpenAI, or Hugging Face (based on configuration in
.env). - 📊 ATS Score: Job seekers can receive an ATS score based on how well their resume matches a job description.
- 💡 Suggestions & Feedback: Detailed suggestions, tips, and graphical representation of how the resume matches the job description.
- ✉️ Resume Sending: Job seekers can send their resumes to recruiters (one resume per recruiter).
- 🎯 Quiz: Job seekers can take a quiz based on the job description to prepare for interviews.
- 📱💻Responsive Design: Fully responsive UI for a seamless experience on mobile and desktop.
- Node.js (v18+ recommended)
- npm or yarn (package managers)
- Firebase storage
- Convex database
- Clerk account and API key (for user authentication)
- Google Cloud Generative AI API or OpenAI API key (for resume analysis)
-
Clone the repository:
git clone https://github.com/Shivam171/next-hire-ai cd next-hire-ai -
Install dependencies:
npm install
-
Configure environment variables by copying
.env.exampleto.envand.env.local.exampleto.env.localand replacing the placeholders with your credentials:cp .env.example .env cp .env.local.example .env.local
-
Run the development server and convex server:
npm run dev npx convex dev
-
Open the app in your browser at
http://localhost:3000.
- Sign Up / Login: After logging in with Clerk, choose your role as either a Recruiter or Job Seeker.
- For Recruiters: View CVs uploaded by job seekers. Filter by skills and view resumes in PDF format.
- For Job Seekers: Upload your resume and paste the job description for the role you're applying for. The app will analyze your resume against the job description and provide an ATS score, along with tips, suggestions, and a quiz.
- ATS Score: The system uses AI to analyze how well your resume matches the job description and provides a score (in percentage).
- Send Resume: Once satisfied, you can send your resume to a recruiter by selecting from a list of recruiters.
- Some links on the homepage may not work as they are mockups.
- If you ran into any issue, Try refreshing your page. It should work, if it didn't worked then create a issue, i'll try to correct them.
- The "Download Report" feature is not fully implemented yet, but feel free to contribute!
If you'd like to contribute, feel free to open a pull request! Here’s a small tip for contributors:
- Missing Feature: A feature for downloading a report after the resume has been analyzed is planned but not yet implemented. If you'd like to add this functionality, it would be a great first contribution.
Please feel free to add more features, fix bugs, or improve the code. I welcome all contributions.
This project is open-source and available under the MIT License.
If you like the idea and think it can help others, feel free to star the repo! ⭐
🙏🏻 Thanks for checking out the project, and I hope you find it useful for improving your resume and job search process. 💼