Skip to content

AI-powered Resume Analyzer built with React & Puter.js. Includes seamless auth, upload and store resumes, and match candidates to jobs using smart AI evaluations. All wrapped in a clean, reusable UI.

License

Notifications You must be signed in to change notification settings

amirallami-code/ai-resume-analyzer

Repository files navigation

AI Resume Analyzer

TypeScript React Tailwind CSS

An intelligent resume analysis platform that leverages AI to evaluate resumes against job descriptions, providing detailed ATS scores and personalized feedback to help candidates optimize their applications.

🌟 Overview

The AI Resume Analyzer is a modern web application designed to bridge the gap between job seekers and applicant tracking systems (ATS). By utilizing advanced AI technology, the platform provides comprehensive resume analysis, helping users understand how well their resumes match specific job requirements and offering actionable insights for improvement.

✨ Key Features

🔐 Seamless Authentication

  • Browser-based authentication system
  • Secure user sessions without complex backend setup
  • Privacy-focused user management

📁 Resume Management

  • Upload and store multiple resumes securely
  • Organize resumes in a centralized dashboard
  • Support for various document formats

🤖 AI-Powered Analysis

  • Intelligent resume-to-job matching algorithms
  • Comprehensive ATS compatibility scoring
  • Detailed feedback and improvement suggestions
  • Custom analysis tailored to specific job listings

🎨 Modern User Experience

  • Clean, intuitive interface design
  • Fully responsive across all devices
  • Consistent UI components for seamless navigation
  • Fast loading times and smooth interactions

🔧 Developer-Friendly Architecture

  • Modular, reusable component structure
  • Type-safe development with TypeScript
  • Efficient state management
  • Optimized build process

🛠️ Technology Stack

  • Frontend Framework: React 18
  • Routing: React Router v7
  • Styling: Tailwind CSS
  • Language: TypeScript
  • State Management: Zustand
  • Build Tool: Vite
  • Backend Services: Puter.js (Authentication, Storage, AI)

🚀 Getting Started

Prerequisites

Ensure you have the following installed on your machine:

Installation

  1. Clone the repository

    git clone https://github.com/yourusername/ai-resume-analyzer.git
    cd ai-resume-analyzer
  2. Install dependencies

    npm install
  3. Start the development server

    npm run dev
  4. Open your browser Navigate to http://localhost:5173 to view the application.

Available Scripts

  • npm run dev - Start the development server
  • npm run build - Build the project for production
  • npm run preview - Preview the production build locally

🏗️ Project Structure

ai-resume-analyzer/
├── App/
│   ├── components/          # Reusable UI components
│   ├── pages/              # Application pages
│   ├── utils/              # Utility functions
│   ├── types/              # TypeScript type definitions
│   └── styles/             # Global styles and Tailwind config
├── public/                 # Static assets
└── ...config files

🎯 Usage

  1. Sign Up/Login: Create an account or log in to access the platform
  2. Upload Resume: Upload your resume in PDF or DOC format
  3. Add Job Description: Paste or upload the job description you're targeting
  4. Get Analysis: Receive comprehensive AI-powered analysis including:
    • ATS compatibility score
    • Keyword matching analysis
    • Skills gap identification
    • Improvement recommendations
  5. Optimize: Apply suggested improvements and re-analyze

🤝 Contributing

We welcome contributions from the community! Please follow these steps:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📝 License

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

🆘 Support

If you encounter any issues or have questions:

  • Check the Issues page
  • Create a new issue with detailed information about your problem
  • Join our community discussions

About

AI-powered Resume Analyzer built with React & Puter.js. Includes seamless auth, upload and store resumes, and match candidates to jobs using smart AI evaluations. All wrapped in a clean, reusable UI.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published