HireFlow AI
huzaifa-fullstack/hireflow-ai
Análise de currículo com IA e score ATS em tempo real
Ver no GitHubAnalisador de currículos com IA que avalia documentos em múltiplas dimensões (ATS, tom, conteúdo, estrutura e skills) e fornece sugestões detalhadas com visualizações animadas. Inclui upload de PDF com drag-and-drop, processamento em-browser seguro e armazenamento em nuvem via Puter.
Instalação
npx convez-ai huzaifa-fullstack/hireflow-ai1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Avaliar compatibilidade de currículo com sistemas ATS antes de enviar candidatura
- Identificar gaps de conteúdo, estrutura e alinhamento de skills em currículos
- Otimizar tom e linguagem do currículo para melhor recepção em processos seletivos
Veredito

Skill bem construído com stack moderno (React 19, TypeScript, Tailwind) e integração nativa com Claude para análise semântica de currículos. Destaque para processamento seguro em-browser via PDF.js e armazenamento via Puter, evitando exposição de dados sensíveis. Útil para candidatos otimizarem candidaturas.
README
A tradução para o português deste README ainda está na fila.
🚀 HireFlow AI – AI-Powered Resume Analysis Platform
🌐 Live Demo: Click here to visitsite
Deployed on Vercel
📋 Overview
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
🏗️ Features
🧠 AI-Powered Resume Analysis
- Overall Score Calculation (0-100)
- Five Key Areas:
- 🎯 ATS Compatibility
- 🎨 Tone & Style
- 📝 Content Quality
- 🏗️ Structure & Format
- ⚡ Skills Alignment
- Expandable Accordions for detailed improvement tips
📊 Interactive Dashboard
- SVG Score Gauges (animated, color-coded)
- Progress Tracking for multiple resumes
- Comparison between versions
🔐 Authentication & Storage
- Puter Cloud OAuth secure login
- File Management for resumes (PDF/image)
- Cross-device syncing
📱 Modern UX/UI
- Responsive design (mobile-first)
- Drag & Drop upload
- Real-time processing, skeleton loaders
- Professional, consistent theming
💻 Technologies Used
- 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
🚀 How to Use
- 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
📸 Screenshots
🔐 Login Page

🏠 Homepage

🛠️ Upload & Manage

📋 Resume Analysis

📊 Score Visualization

🎥 Preview

🎨 Design System
Color Palette
- Primary:
#1f2937(Gray-800) - Success:
#10b981(Emerald-500) - Warning:
#f59e0b(Amber-500) - Danger:
#ef4444(Red-500) - Background: Custom gradients
Component Architecture
- Atomic/Compound Components for reusability
- Responsive Utilities – Mobile-first
- Accessibility – Semantic HTML, ARIA labels
Animation System
- Smooth 300ms transitions
- Skeleton screens, spinners for loading
- Micro-interactions for engagement
- CSS transforms for performance
🔒 Security & Privacy
- 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
📈 Performance Optimizations
- 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)
🔄 Deployment & DevOps
npm run build # Production build
npm run typecheck # TypeScript check
npm run dev # Hot reload
Supported Platforms:
- Vercel – Optimized for React Router
- Self-hosted – Node.js
- Docker – Container ready
🐛 Error Handling & Debugging
- AI Failures: Fallback to mock data
- Network Issues: Retry & feedback
- File Errors: User-friendly messages
- Auth Failures: Secure redirects
- Console Logging, Error Boundaries, HMR
🚧 Future Enhancements
- 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
📊 Project Metrics
- 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
👨💻 Development Journey
Problem Identification
ATS optimization is a black box for most job seekers. HireFlow AI aims to make resume success measurable and improvable.
Solution Architecture
- Modern web stack for UX
- Cloud + AI for intelligence and security
- Mobile-first, accessible design
Key Challenges
- Reliable client-side PDF/image rendering
- Resilient AI fallback/error handling
- Seamless cloud integration
- Fast, mobile UI
Tech Decisions
- React Router 7
- Puter Platform
- End-to-end TypeScript
- Tailwind CSS for rapid UI
🤝 Contributing
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
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
✍️ Author
Muhammad Huzaifa Karim
GitHub Profile
📬 Contact
Feel free to reach out if you have any questions or feedback!
Email: karimhuzaifa590@gmail.com
© 2025 Muhammad Huzaifa Karim