https://github.com/aviralmehrotra/cvscan
A modern web application that provides intelligent feedback on resumes using AI analysis. Built with React Router and powered by Puter's cloud services.
https://github.com/aviralmehrotra/cvscan
puterjs react-router typescript
Last synced: about 2 months ago
JSON representation
A modern web application that provides intelligent feedback on resumes using AI analysis. Built with React Router and powered by Puter's cloud services.
- Host: GitHub
- URL: https://github.com/aviralmehrotra/cvscan
- Owner: AviralMehrotra
- License: mit
- Created: 2025-09-13T12:06:12.000Z (9 months ago)
- Default Branch: master
- Last Pushed: 2025-09-13T12:09:13.000Z (9 months ago)
- Last Synced: 2025-09-13T14:40:32.714Z (9 months ago)
- Topics: puterjs, react-router, typescript
- Language: JavaScript
- Homepage: https://cv-scan-eta.vercel.app
- Size: 3.77 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 
CVScan – AI-Powered Resume Intelligence
> **Analyze your resume. Fix gaps. Get shortlisted.** CVScan is a state-of-the-art AI-driven platform designed to help job seekers optimize their resumes for modern Applicant Tracking Systems (ATS) and human recruiters alike.
[](https://github.com/aviralmehrotra/cvscan)
[](https://opensource.org/licenses/MIT)
[](https://reactrouter.com/)
[](https://tailwindcss.com/)
[](https://puter.com/)
---
## 🚀 Live Demo
Experience the power of AI resume analysis: **[Try CVScan Now](https://cv-scan-eta.vercel.app/)**
---
## ✨ Key Features
- 🧠 **Deep AI Analysis** – Leverages advanced LLMs to provide granular feedback on content, structure, and professional tone.
- 📊 **ATS Compatibility Score** – Understand how well your resume performs against automated screening systems.
- 🎯 **Job-Specific Tailoring** – Analyze your resume against specific job descriptions to find missing keywords and skills.
- 📄 **Interactive PDF Preview** – Real-time rendering of your resume with overlaid AI insights.
- 🔐 **Cloud-Native Auth** – Secure, seamless authentication powered by Puter.js.
- 📱 **Ultra-Responsive UI** – A premium, dark-themed experience that works beautifully on any device.
---
## 🛠️ Tech Stack
### Frontend
- **Framework:** [React Router v7](https://reactrouter.com/) (Full-stack React framework)
- **Styling:** [Tailwind CSS v4](https://tailwindcss.com/) (Next-gen utility-first CSS)
- **Icons:** [Lucide React](https://lucide.dev/)
- **State Management:** [Zustand](https://zustand-demo.pmnd.rs/)
- **Animations:** [Tailwind Animate](https://github.com/jamiebuilds/tailwindcss-animate)
### Backend & Cloud (Puter.js)
- **Authentication:** Puter Auth
- **Database/KV:** Puter Key-Value Store
- **AI Engine:** Puter AI (LLM integration)
- **Hosting:** Puter Cloud Platform
### Utilities
- **PDF Processing:** [PDF.js](https://mozilla.github.io/pdf.js/)
- **File Handling:** [React Dropzone](https://react-dropzone.js.org/)
---
## 📂 Project Structure
```bash
app/
├── components/ # Premium UI components (Gauges, Cards, Uploaders)
│ ├── ATS.tsx # ATS scoring visualization
│ ├── FileUploader.tsx # Drag & drop with PDF validation
│ ├── ScoreGauge.tsx # Animated SVG gauges for metrics
│ └── LandingPage.tsx # High-conversion hero sections
├── routes/ # Application routing & page logic
│ ├── dashboard.tsx # User's resume management hub
│ ├── upload.tsx # AI analysis pipeline
│ ├── resume.tsx # Detailed feedback & preview
│ └── auth.tsx # Puter-powered authentication
├── lib/ # Core business logic & API wrappers
│ ├── puter.ts # Puter.js SDK integration
│ └── pdf2img.ts # Client-side PDF to Image conversion
└── app.css # Global styles & Tailwind v4 configuration
```
---
## 🏁 Getting Started
### Prerequisites
- **Node.js:** 18.x or higher
- **Package Manager:** npm, pnpm, or yarn
### Installation
1. **Clone the repository:**
```bash
git clone https://github.com/aviralmehrotra/cvscan.git
cd cvscan
```
2. **Install dependencies:**
```bash
npm install
```
3. **Run the development server:**
```bash
npm run dev
```
The app will be available at `http://localhost:5173`.
4. **Build for production:**
```bash
npm run build
```
---
## 🔍 How It Works
1. **Upload:** Drop your PDF resume into the secure uploader.
2. **Context:** (Optional) Provide a job description for targeted analysis.
3. **Process:** PDF.js converts your resume for client-side preview while Puter AI analyzes the text content.
4. **Insights:** Receive a comprehensive breakdown across 5 key dimensions:
- **ATS Score:** Technical compatibility.
- **Content:** Information density and relevance.
- **Structure:** Layout and readability.
- **Tone:** Professionalism and impact.
- **Skills:** Keyword matching and skill gaps.
---
## 🤝 Contributing
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
---
## 📜 License
Distributed under the MIT License. See `LICENSE` for more information.
---
## 🙌 Acknowledgments
- [Puter.js](https://puter.com/) for the incredible cloud infrastructure.
- [React Router](https://reactrouter.com/) for the seamless routing experience.
- [Tailwind CSS](https://tailwindcss.com/) for making styling a breeze.
---
Built with ❤️ by Aviral Mehrotra