Smart AI-powered resume analysis with job matching and performance tracking
✨ Features • 🚀 Quick Start • ⚙️ Tech Stack • 📚 Docs • 🤝 Contributing
- ✨ Introduction
- ⚙️ Tech Stack
- 🔋 Features
- 🤸 Quick Start
- 🔗 Assets
- 🚀 More
AI Resume Analyzer is a comprehensive web application that transforms the job search process through intelligent resume optimization. Built with cutting-edge technologies, it provides job seekers with AI-powered insights, job matching capabilities, and performance analytics to maximize their career success.
Transform your job search with:
- AI-Powered Analysis: Get detailed feedback across 5 key categories (ATS, Content, Skills, Structure, Tone)
- Smart Job Matching: Compare your resume against real job postings with compatibility scores
- Performance Tracking: Monitor improvements over time with comprehensive analytics
- Personalized Recommendations: Receive specific, actionable advice to improve your resume
- No Backend Required: Powered entirely by Puter.js cloud services
- Enterprise-Grade AI: Uses Claude and GPT models for analysis
- Real-Time Processing: Instant feedback and analysis
- Comprehensive Analytics: Track performance across multiple resumes and job applications
- Modern Architecture: Built with React 19, React Router v7, and TypeScript
-
React is a popular open‑source JavaScript library for building user interfaces using reusable components and a virtual DOM, enabling efficient, dynamic single-page and native apps.
-
React Router v7 is the go‑to routing library for React apps, offering nested routes, data loaders/actions, error boundaries, code splitting, and SSR support—all with a smooth upgrade path from v6.
-
Puter.com is an advanced, open-source internet operating system designed to be feature-rich, exceptionally fast, and highly extensible. Puter can be used as: A privacy-first personal cloud to keep all your files, apps, and games in one secure place, accessible from anywhere at any time.
-
Puter.js is a tiny client‑side SDK that adds serverless auth, storage, database, and AI (GPT, Claude, DALL·E, OCR…) straight into your browser app—no backend needed and costs borne by users.
-
Tailwind CSS is a utility-first CSS framework that allows developers to design custom user interfaces by applying low-level utility classes directly in HTML, streamlining the design process.
-
TypeScript is a superset of JavaScript that adds static typing, providing better tooling, code quality, and error detection for developers, making it ideal for building large-scale applications.
-
Vite is a fast build tool and dev server using native ES modules for instant startup, hot‑module replacement, and Rollup‑powered production builds—perfect for modern web development.
-
Zustand is a minimal, hook-based state management library for React. It lets you manage global state with zero boilerplate, no context providers, and excellent performance through selective state subscriptions.
- 5-Category Scoring: ATS compatibility, content quality, tone & style, structure, and skills assessment
- Detailed Feedback: Specific tips and recommendations for each category
- Smart Prompting: Advanced AI prompts for accurate, actionable insights
- Fallback Systems: Reliable feedback even when AI services are unavailable
- Real Job Postings: 5 sample jobs from top tech companies (Google, Microsoft, Apple, Amazon, Netflix)
- Compatibility Scoring: Skills match, experience fit, keyword analysis, and overall compatibility
- Visual Indicators: Color-coded skills (matching vs. missing)
- Detailed Breakdowns: Comprehensive match analysis with improvement recommendations
- Resume Comparison: Side-by-side comparison of up to 3 resumes
- Trend Tracking: Monitor improvement trends over time
- Portfolio Analytics: Overall performance metrics across all resumes
- Best Performer Identification: Automatically identify top-performing resumes
- Insights Generation: AI-powered recommendations based on performance data
- Browser-Based Auth: Seamless authentication with Puter.js (no backend setup required)
- Cloud Storage: Secure file storage and retrieval
- Data Persistence: Resume data and analytics stored reliably
- User Profiles: Personalized experience with user-specific data
- Responsive Design: Optimized for desktop, tablet, and mobile devices
- Loading States: Skeleton loaders and smooth transitions
- Error Handling: Comprehensive error boundaries and user feedback
- Accessibility: Built with accessibility best practices
- Performance: Optimized bundle splitting and lazy loading
- TypeScript: Full type safety throughout the application
- Testing Suite: Comprehensive tests with Vitest and Testing Library
- Performance Monitoring: Bundle analysis and optimization tools
- Documentation: Extensive documentation and code comments
- Modern Tooling: Vite, React Router v7, and latest React features
Follow these steps to set up the project locally on your machine.
Prerequisites
Make sure you have the following installed on your machine:
Cloning the Repository
git clone https://github.com/adrianhajdin/ai-resume-analyzer.git
cd ai-resume-analyzerInstallation
Install the project dependencies using npm:
npm installRunning the Project
npm run devOpen http://localhost:5173 in your browser to view the project.
Project assets are included in the public directory.
For detailed documentation, please refer to:
- Development Guide - Comprehensive development documentation
- API Reference - Complete API documentation
- Testing Guide - How to run and write tests
- Performance Guide - Optimization and monitoring
- Deployment Guide - Production deployment options
graph TB
A[User] --> B[React Frontend]
B --> C[React Router v7]
B --> D[Zustand Store]
D --> E[Puter.js SDK]
E --> F[Puter Cloud]
F --> G[AI Services]
F --> H[File Storage]
F --> I[Auth Service]
F --> J[Key-Value Store]
| Component | Technology | Purpose |
|---|---|---|
| Frontend | React 19 + TypeScript | Modern UI with type safety |
| Routing | React Router v7 | Full-stack routing with SSR |
| Styling | Tailwind CSS v4 | Utility-first styling |
| State | Zustand | Lightweight state management |
| Backend | Puter.js | Cloud services (auth, storage, AI) |
| Testing | Vitest + Testing Library | Comprehensive test coverage |
| Build | Vite | Fast development and builds |
We welcome contributions! Here's how you can help:
- 🐛 Report bugs by opening issues
- 🎆 Request features or enhancements
- 📝 Improve documentation
- 💻 Submit code improvements
- ✨ Add new features
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Install dependencies:
npm install - Make your changes
- Test your changes:
npm run test - Check types:
npm run typecheck - Commit your changes:
git commit -m 'feat: add amazing feature' - Push to your branch:
git push origin feature/amazing-feature - Open a Pull Request
- TypeScript: Strict mode enabled
- Testing: Write tests for new features
- Documentation: Update docs for API changes
- Commits: Follow conventional commit format
- Code Style: Consistent with existing patterns
- 💬 Discussions: For questions and ideas
- 🐛 Issues: For bugs and feature requests
- 📚 Documentation: Check DEVELOPMENT.md first
- AI-powered resume analysis
- Job matching dashboard
- Performance analytics
- Authentication system
- Responsive UI/UX
- Testing framework
- Performance optimization
- Email notifications for analysis completion
- Resume templates and suggestions
- Integration with job boards (LinkedIn, Indeed)
- Advanced analytics and insights
- Mobile app version
- Team/enterprise features
This project is open source and available under the MIT License.
Made with ❤️ and cutting-edge tech