🌐 Live Demo: Click here to visitsite
The HireFlow AI platform is an AI-powered resume analyzer that provides actionable feedback and ATS compatibility scoring for job seekers.
It delivers a modern, interactive experience while ensuring security, privacy, and cross-device cloud access.
Key highlights include:
- Real-time multi-category AI resume analysis (ATS, Tone, Content, Structure, Skills)
- Animated score visualizations and detailed improvement suggestions
- Drag-and-drop PDF upload & high-quality in-browser PDF processing
- Secure authentication & file storage with Puter Cloud
- Fast, mobile-responsive UI built with React 19, TypeScript, Tailwind, and Vite
- GDPR compliant and privacy focused by design
- Overall Score Calculation (0-100)
- Five Key Areas:
- 🎯 ATS Compatibility
- 🎨 Tone & Style
- 📝 Content Quality
- 🏗️ Structure & Format
- ⚡ Skills Alignment
- Expandable Accordions for detailed improvement tips
- SVG Score Gauges (animated, color-coded)
- Progress Tracking for multiple resumes
- Comparison between versions
- Puter Cloud OAuth secure login
- File Management for resumes (PDF/image)
- Cross-device syncing
- Responsive design (mobile-first)
- Drag & Drop upload
- Real-time processing, skeleton loaders
- Professional, consistent theming
- React 19.1.0 — Modern, concurrent UI library
- TypeScript 5.8.3 — Type-safe JavaScript
- Tailwind CSS 4.1.4 — Utility-first styling
- Vite 6.3.3 — Lightning-fast builds
- React Router 7.7.1 — File-based routing
- Zustand 5.0.8 — Lightweight state management
- PDF.js 5.3.93 — Client-side PDF rendering
- Canvas API — Image processing
- Puter.js — Cloud auth, storage, and AI
- ES2020+ JavaScript — Modern programming language for web development
- CSS3 — Styling language for designing web pages
- HTML5 — Markup language for structuring web content
- Clone the repository
git clone https://github.com/huzaifa-fullstack/hireflow-ai.git
cd hireflow-ai- Install dependencies
npm install- Start development server
npm run dev- Open your browser
http://localhost:5173- Build for production
npm run build
npm run start
- Primary:
#1f2937(Gray-800) - Success:
#10b981(Emerald-500) - Warning:
#f59e0b(Amber-500) - Danger:
#ef4444(Red-500) - Background: Custom gradients
- Atomic/Compound Components for reusability
- Responsive Utilities – Mobile-first
- Accessibility – Semantic HTML, ARIA labels
- Smooth 300ms transitions
- Skeleton screens, spinners for loading
- Micro-interactions for engagement
- CSS transforms for performance
- Client-side PDF Processing
- Encrypted Cloud Storage (Puter)
- No Data Mining
- GDPR Compliant (right to deletion)
- OAuth Flow – Secure login
- Session Management – Auto token refresh
- Access Control – User-specific data
- Code Splitting (route-based lazy loading)
- Image Optimization (WebP, fallbacks)
- Bundle Analysis (minimized JS)
- Caching (Browser & CDN)
- Web Workers (background PDF rendering)
- Error Boundaries (UI stability)
npm run build # Production build
npm run typecheck # TypeScript check
npm run dev # Hot reloadSupported Platforms:
- Vercel – Optimized for React Router
- Self-hosted – Node.js
- Docker – Container ready
- AI Failures: Fallback to mock data
- Network Issues: Retry & feedback
- File Errors: User-friendly messages
- Auth Failures: Secure redirects
- Console Logging, Error Boundaries, HMR
- Multi-format Support: Word/Plain text
- Batch Processing: Multiple resumes
- Industry Templates: Sector-specific
- Collaboration: Share/compare resumes
- Advanced Analytics: History, trends
- Integration APIs: Job boards
- PWA: Offline support
- AI Fine-tuning: Custom models
- A/B Testing: Features
- Components: 12+ React
- Routes: 5 main
- Types: 20+ TypeScript
- Lines of Code: 2,500+
- Dependencies: 15 prod, 8 dev
Key Features:
- Auth & session management
- Drag & drop upload
- PDF → Image conversion
- AI-powered analysis
- Cloud data persistence
- Responsive UI
- Robust error handling
- Performance optimization
ATS optimization is a black box for most job seekers. HireFlow AI aims to make resume success measurable and improvable.
- Modern web stack for UX
- Cloud + AI for intelligence and security
- Mobile-first, accessible design
- Reliable client-side PDF/image rendering
- Resilient AI fallback/error handling
- Seamless cloud integration
- Fast, mobile UI
- React Router 7
- Puter Platform
- End-to-end TypeScript
- Tailwind CSS for rapid UI
Contributions are welcome!
Open issues, fork, submit PRs. For major changes, please discuss first.
Workflow:
- Fork the repo
- Create a branch
- Commit and push
- Open a PR
This project is licensed under the MIT License - see the LICENSE file for details.
Muhammad Huzaifa Karim
GitHub Profile
Feel free to reach out if you have any questions or feedback!
Email: karimhuzaifa590@gmail.com
© 2025 Muhammad Huzaifa Karim