{"id":31788631,"url":"https://github.com/aviralmehrotra/cvscan","last_synced_at":"2026-05-07T04:35:22.018Z","repository":{"id":314597512,"uuid":"1056109250","full_name":"AviralMehrotra/CVScan","owner":"AviralMehrotra","description":"A modern web application that provides intelligent feedback on resumes using AI analysis. Built with React Router and powered by Puter's cloud services.","archived":false,"fork":false,"pushed_at":"2025-09-13T12:09:13.000Z","size":3948,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-09-13T14:40:32.714Z","etag":null,"topics":["puterjs","react-router","typescript"],"latest_commit_sha":null,"homepage":"https://cv-scan-eta.vercel.app","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AviralMehrotra.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-13T12:06:12.000Z","updated_at":"2025-09-13T12:26:41.000Z","dependencies_parsed_at":"2025-09-13T14:40:34.886Z","dependency_job_id":"a1d88b3c-580a-41bf-a404-6b2b86c5239f","html_url":"https://github.com/AviralMehrotra/CVScan","commit_stats":null,"previous_names":["aviralmehrotra/cvscan"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/AviralMehrotra/CVScan","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AviralMehrotra%2FCVScan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AviralMehrotra%2FCVScan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AviralMehrotra%2FCVScan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AviralMehrotra%2FCVScan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AviralMehrotra","download_url":"https://codeload.github.com/AviralMehrotra/CVScan/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AviralMehrotra%2FCVScan/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279004174,"owners_count":26083688,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-10T02:00:06.843Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["puterjs","react-router","typescript"],"created_at":"2025-10-10T14:24:22.992Z","updated_at":"2026-05-07T04:35:22.001Z","avatar_url":"https://github.com/AviralMehrotra.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \u003cimg src=\"public/favicon.ico\" alt=\"CVScan Logo\" width=\"32\" /\u003e CVScan – AI-Powered Resume Intelligence\n\n![CVScan Banner](https://raw.githubusercontent.com/AviralMehrotra/CVScan/refs/heads/master/public/banner.png)\n\n\u003e **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.\n\n[![Build Status](https://img.shields.io/badge/build-passing-brightgreen?style=for-the-badge)](https://github.com/aviralmehrotra/cvscan)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)\n[![React Router](https://img.shields.io/badge/React%20Router-v7-CA4245?style=for-the-badge\u0026logo=reactrouter)](https://reactrouter.com/)\n[![Tailwind CSS](https://img.shields.io/badge/Tailwind%20CSS-v4-06B6D4?style=for-the-badge\u0026logo=tailwindcss)](https://tailwindcss.com/)\n[![Puter](https://img.shields.io/badge/Cloud-Puter-7B42BC?style=for-the-badge)](https://puter.com/)\n\n---\n\n## 🚀 Live Demo\n\nExperience the power of AI resume analysis: **[Try CVScan Now](https://cv-scan-eta.vercel.app/)**\n\n---\n\n## ✨ Key Features\n\n- 🧠 **Deep AI Analysis** – Leverages advanced LLMs to provide granular feedback on content, structure, and professional tone.\n- 📊 **ATS Compatibility Score** – Understand how well your resume performs against automated screening systems.\n- 🎯 **Job-Specific Tailoring** – Analyze your resume against specific job descriptions to find missing keywords and skills.\n- 📄 **Interactive PDF Preview** – Real-time rendering of your resume with overlaid AI insights.\n- 🔐 **Cloud-Native Auth** – Secure, seamless authentication powered by Puter.js.\n- 📱 **Ultra-Responsive UI** – A premium, dark-themed experience that works beautifully on any device.\n\n---\n\n## 🛠️ Tech Stack\n\n### Frontend\n\n- **Framework:** [React Router v7](https://reactrouter.com/) (Full-stack React framework)\n- **Styling:** [Tailwind CSS v4](https://tailwindcss.com/) (Next-gen utility-first CSS)\n- **Icons:** [Lucide React](https://lucide.dev/)\n- **State Management:** [Zustand](https://zustand-demo.pmnd.rs/)\n- **Animations:** [Tailwind Animate](https://github.com/jamiebuilds/tailwindcss-animate)\n\n### Backend \u0026 Cloud (Puter.js)\n\n- **Authentication:** Puter Auth\n- **Database/KV:** Puter Key-Value Store\n- **AI Engine:** Puter AI (LLM integration)\n- **Hosting:** Puter Cloud Platform\n\n### Utilities\n\n- **PDF Processing:** [PDF.js](https://mozilla.github.io/pdf.js/)\n- **File Handling:** [React Dropzone](https://react-dropzone.js.org/)\n\n---\n\n## 📂 Project Structure\n\n```bash\napp/\n├── components/          # Premium UI components (Gauges, Cards, Uploaders)\n│   ├── ATS.tsx          # ATS scoring visualization\n│   ├── FileUploader.tsx # Drag \u0026 drop with PDF validation\n│   ├── ScoreGauge.tsx   # Animated SVG gauges for metrics\n│   └── LandingPage.tsx  # High-conversion hero sections\n├── routes/              # Application routing \u0026 page logic\n│   ├── dashboard.tsx    # User's resume management hub\n│   ├── upload.tsx       # AI analysis pipeline\n│   ├── resume.tsx       # Detailed feedback \u0026 preview\n│   └── auth.tsx         # Puter-powered authentication\n├── lib/                 # Core business logic \u0026 API wrappers\n│   ├── puter.ts         # Puter.js SDK integration\n│   └── pdf2img.ts       # Client-side PDF to Image conversion\n└── app.css              # Global styles \u0026 Tailwind v4 configuration\n```\n\n---\n\n## 🏁 Getting Started\n\n### Prerequisites\n\n- **Node.js:** 18.x or higher\n- **Package Manager:** npm, pnpm, or yarn\n\n### Installation\n\n1. **Clone the repository:**\n\n   ```bash\n   git clone https://github.com/aviralmehrotra/cvscan.git\n   cd cvscan\n   ```\n\n2. **Install dependencies:**\n\n   ```bash\n   npm install\n   ```\n\n3. **Run the development server:**\n\n   ```bash\n   npm run dev\n   ```\n\n   The app will be available at `http://localhost:5173`.\n\n4. **Build for production:**\n   ```bash\n   npm run build\n   ```\n\n---\n\n## 🔍 How It Works\n\n1. **Upload:** Drop your PDF resume into the secure uploader.\n2. **Context:** (Optional) Provide a job description for targeted analysis.\n3. **Process:** PDF.js converts your resume for client-side preview while Puter AI analyzes the text content.\n4. **Insights:** Receive a comprehensive breakdown across 5 key dimensions:\n   - **ATS Score:** Technical compatibility.\n   - **Content:** Information density and relevance.\n   - **Structure:** Layout and readability.\n   - **Tone:** Professionalism and impact.\n   - **Skills:** Keyword matching and skill gaps.\n\n---\n\n## 🤝 Contributing\n\nContributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n---\n\n## 📜 License\n\nDistributed under the MIT License. See `LICENSE` for more information.\n\n---\n\n## 🙌 Acknowledgments\n\n- [Puter.js](https://puter.com/) for the incredible cloud infrastructure.\n- [React Router](https://reactrouter.com/) for the seamless routing experience.\n- [Tailwind CSS](https://tailwindcss.com/) for making styling a breeze.\n\n---\n\n\u003cp align=\"center\"\u003e\n  Built with ❤️ by \u003ca href=\"https://github.com/aviralmehrotra\"\u003eAviral Mehrotra\u003c/a\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faviralmehrotra%2Fcvscan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faviralmehrotra%2Fcvscan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faviralmehrotra%2Fcvscan/lists"}