AI Resume Checker

📋 Table of Contents

1. ✨ Introduction
2. ⚙️ Tech Stack
3. 🔋 Features
4. 🤸 Quick Start

✨ Introduction

[EN] AI-powered Resume Analyzer built with React, React Router, and Puter.js — featuring seamless authentication, resume upload and storage, smart AI-based candidate matching, personalized feedback, and ATS scores tailored to each job listing, all within a clean, reusable UI.

[FR] Un analyseur de CV propulsé par l’IA, développé avec React, React Router et Puter.js — avec une authentification fluide, l’upload et le stockage de CV, un système intelligent de mise en relation candidats/offres, des retours personnalisés et des scores ATS adaptés à chaque annonce, le tout dans une interface propre et réutilisable.

⚙️ Tech Stack

• 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.

🔋 Features

👉 Easy & convenient auth: Handle authentication entirely in the browser using Puter.js—no backend or setup required.

👉 Resume upload & storage: Let users upload and store all their resumes in one place, safely and reliably.

👉 AI resume matching: Provide a job listing and get an ATS score with custom feedback tailored to each resume.

👉 Reusable, modern UI: Built with clean, consistent components for a great-looking and maintainable interface.

👉 Code Reusability: Leverage reusable components and a modular codebase for efficient development.

👉 Cross-Device Compatibility: Fully responsive design that works seamlessly across all devices.

👉 Modern UI/UX: Clean, responsive design built with Tailwind CSS and shadcn/ui for a sleek user experience.

And many more, including code architecture and reusability.

🤸 Quick Start

Follow these steps to set up the project locally on your machine.

Prerequisites

Make sure you have the following installed on your machine:

• Git
• Node.js
• npm (Node Package Manager)

Cloning the Repository

git clone [git remote URL]

Installation

Install the project dependencies using npm:

npm install

Running the Project

npm run dev

Open http://localhost:5173 in your browser to view the project.