convez.ai
SkillMarketing & VendasIntermediário
huzaifa-fullstack

HireFlow AI

huzaifa-fullstack/hireflow-ai

Análise de currículo com IA e score ATS em tempo real

Ver no GitHub
InicialPluginScore · de 0 a 100

Analisador 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-ai

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
50%
Último commit
há 1 ano
Versão
—
Issues abertas
0
Contribuidores
1

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

HireFlow AI React TypeScript Tailwind CSS Vite React Router Zustand PDF.js Canvas API Web Workers React Dropzone clsx tailwind-merge Puter Cloud Claude (Sonnet) JavaScript HTML5 CSS3 Node.js Vercel Docker MIT License Project Status

🌐 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


🚀 How to Use

  1. Clone the repository
git clone https://github.com/huzaifa-fullstack/hireflow-ai.git
cd hireflow-ai
  1. Install dependencies
npm install
  1. Start development server
npm run dev
  1. Open your browser
http://localhost:5173
  1. Build for production
npm run build
npm run start

📸 Screenshots

🔐 Login Page

Login Page


🏠 Homepage

Homepage


🛠️ Upload & Manage

Upload & Manage


📋 Resume Analysis

Resume Analysis


📊 Score Visualization

Score Visualization


🎥 Preview

Preview GIF


🎨 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:

  1. Fork the repo
  2. Create a branch
  3. Commit and push
  4. 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

Ver o original no GitHub

Bom para

Relacionados