ResumeIQ - Smart Resume Analysis Platform

ResumeIQ is an intelligent resume analysis platform that helps job seekers optimize their resumes for Applicant Tracking Systems (ATS) and get personalized feedback using AI-powered analysis.

✨ Features

🚀 AI-Powered Analysis - Get comprehensive feedback on your resume's effectiveness
📊 ATS Compatibility Scoring - Understand how well your resume performs against ATS systems
🎯 Personalized Recommendations - Receive targeted suggestions based on job descriptions
📱 Fully Responsive Design - Optimized for desktop, tablet, and mobile devices with adaptive layouts
🔐 Flexible Authentication - Optional login system - explore the platform without signing up first
☁️ Cloud Storage - Secure file storage and management through Puter.js
⚡ Real-time Processing - Instant feedback and analysis results
🎨 Modern UI - Beautiful, intuitive interface built with Tailwind CSS and custom components
📋 Detailed Feedback - Comprehensive analysis including tone, content, structure, and skills assessment
🔄 Resume Preview - Visual preview of uploaded resumes with analysis results

🛠️ Tech Stack

Frontend: React 18, TypeScript, Tailwind CSS
Backend: Puter.js (Cloud Platform)
Routing: React Router v7
Build Tool: Vite
File Upload: React Dropzone
UI Components: Custom components with Tailwind CSS
Icons: Custom SVG icons
Deployment: Docker-ready
PDF Processing: Custom PDF to image conversion
State Management: React hooks with Puter.js integration

🚀 Getting Started

Prerequisites

Node.js 18+
npm or yarn
Puter.js account (for cloud features)

Installation

Clone the repository

git clone https://github.com/flypsid/resumeiq.git
cd resumeiq

Install dependencies
```
npm install
```
Environment Setup Create a .env file in the root directory:
```
PUTER_API_KEY=your_puter_api_key
```
Start the development server
```
npm run dev
```

Your application will be available at http://localhost:5173.

📖 Usage

For Job Seekers

Explore the Platform - Browse the homepage without signing up
Sign Up/Login - Create an account using Puter.js authentication when ready to upload
Upload Resume - Drag and drop your PDF resume or click to browse
Enter Job Details - Provide company name, job title, and job description
Get Analysis - Receive comprehensive feedback including:
- ATS compatibility score with detailed breakdown
- Content quality assessment (tone, structure, skills)
- Personalized improvement suggestions
- Visual resume preview with analysis results

Key Features Explained

ATS Analysis

ResumeIQ analyzes your resume against common ATS criteria:

Keyword matching with job descriptions
Readable formatting (ATS-friendly layouts)
File format compatibility
Content structure optimization

AI-Powered Feedback

Using advanced AI models, ResumeIQ provides:

Personalized improvement suggestions
Industry-specific recommendations
Competitive analysis insights
Actionable next steps
Detailed scoring across multiple categories

Mobile-First Design

Responsive Layouts: Optimized for all screen sizes
Touch-Friendly: Large buttons and intuitive navigation
Adaptive Components: Components that adjust based on screen size
Mobile Navigation: Streamlined navigation for mobile users

🔧 Configuration

Puter.js Integration

ResumeIQ uses Puter.js as its cloud platform for:

Authentication: Secure user login and session management
File Storage: Resume uploads and temporary file processing
AI Processing: Integration with AI models for analysis
Data Persistence: Secure storage of analysis results

Environment Variables

# Puter.js Configuration
PUTER_API_KEY=your_puter_api_key_here
PUTER_APP_ID=your_app_id_here

# Optional: Custom API endpoints
API_BASE_URL=https://api.puter.com

🏗️ Project Structure

resumeiq/
├── app/
│   ├── components/          # Reusable UI components
│   │   ├── FileUploader.tsx # Drag-and-drop file upload component
│   │   ├── navbar.tsx       # Navigation with conditional auth
│   │   ├── Summary.tsx      # Resume score summary with gauge
│   │   ├── ATS.tsx          # ATS scoring component
│   │   ├── Details.tsx      # Detailed feedback with accordions
│   │   ├── ResumeCarousel.tsx # Homepage feature showcase
│   │   ├── ScoreGauge.tsx   # Circular score visualization
│   │   ├── ScoreBadge.tsx   # Score badges for categories
│   │   ├── Accordion.tsx    # Collapsible content component
│   │   └── footer.tsx       # Site footer
│   ├── routes/              # Page routes
│   │   ├── auth.tsx         # Authentication page
│   │   ├── upload.tsx       # Resume upload and analysis
│   │   ├── home.tsx         # Landing page (no auth required)
│   │   ├── resume.tsx       # Analysis results page
│   │   └── root.tsx         # App root with providers
│   ├── lib/                 # Utility libraries
│   │   ├── puter.ts         # Puter.js integration
│   │   ├── utils.ts         # Helper functions
│   │   ├── pdf2img.ts       # PDF to image conversion
│   │   └── ...
│   ├── app.css              # Global styles and Tailwind imports
│   └── root.tsx             # App entry point
├── public/                  # Static assets
│   ├── images/              # Background images and assets
│   │   ├── bgmain.jpg       # Main background
│   │   ├── logo.jpg         # App logo
│   │   └── resume-scan.gif  # Loading animation
│   ├── icons/               # Custom SVG icons
│   │   ├── back.svg         # Navigation icons
│   │   ├── check.svg        # Success indicators
│   │   └── ...
│   └── pdf.worker.min.mjs   # PDF processing worker
├── types/                   # TypeScript definitions
│   ├── index.d.ts           # Main type definitions
│   └── puter.d.ts           # Puter.js type definitions
├── constants/               # Application constants
│   └── index.ts             # App configuration and prompts
├── Dockerfile               # Docker configuration
├── package.json             # Dependencies and scripts
├── vite.config.ts           # Vite build configuration
├── tsconfig.json            # TypeScript configuration
└── tailwind.config.js       # Tailwind CSS configuration

🚀 Building for Production

Create a production build:

npm run build

The build artifacts will be stored in the build/ directory.

🆕 Recent Updates

Version 1.1.0 - Enhanced User Experience

Flexible Authentication: Users can now explore the homepage without signing up
Mobile Optimization: Complete responsive redesign for mobile devices
Improved UI Components:
- Enhanced ATS scoring display with better visual hierarchy
- Redesigned summary section with centered score gauge
- Mobile-first accordion components for detailed feedback
- Adaptive navigation with conditional authentication
Better Loading States: Improved user feedback during analysis
Enhanced File Upload: Better drag-and-drop experience with visual feedback

Key Improvements

Mobile Responsiveness

Adaptive layouts for all screen sizes
Touch-optimized buttons and interactions
Responsive typography and spacing
Mobile-first component design

User Experience

No mandatory authentication for exploration
Streamlined onboarding process
Better visual feedback and loading states
Improved navigation flow

Technical Enhancements

Optimized component rendering
Better error handling
Enhanced TypeScript integration
Improved build performance

🐳 Docker Deployment

Build the Docker image

docker build -t resumeiq .

Run the container

docker run -p 3000:3000 resumeiq

Deploy to cloud platforms

The containerized application can be deployed to:

Cloudflare
VPS/Coolify/Dokploy
AWS ECS/Fargate
Google Cloud Run
Azure Container Apps
Digital Ocean App Platform
Fly.io
Railway
Vercel
Netlify

🤝 Contributing

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Puter.js - Cloud platform powering authentication, storage, and AI services
React Router v7 - Modern client-side routing with data loading
Tailwind CSS - Utility-first CSS framework for responsive design
React Dropzone - Robust file upload functionality
Vite - Fast build tool and development server
TypeScript - Type-safe JavaScript development
React 18 - Latest React features including concurrent rendering
Custom Components - Handcrafted UI components for optimal UX
PDF-lib - PDF processing and image conversion
React Icons - Consistent icon system throughout the app

📞 Support

If you have any questions or need help:

🌐 Web: https://rfx.life
📧 Email: contact@rfx.life

📈 Roadmap

Upcoming Features

Planned Improvements

Built with ❤️ using React, TypeScript, and Puter.js

Last updated: September 2025

Name		Name	Last commit message	Last commit date
Latest commit History 25 Commits
app		app
constants		constants
public		public
types		types
.dockerignore		.dockerignore
.gitignore		.gitignore
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
package-lock.json		package-lock.json
package.json		package.json
react-router.config.ts		react-router.config.ts
tsconfig.json		tsconfig.json
vite.config.ts		vite.config.ts

Folders and files

Latest commit

History

Repository files navigation

ResumeIQ - Smart Resume Analysis Platform

✨ Features

🛠️ Tech Stack

🚀 Getting Started

Prerequisites

Installation

📖 Usage

For Job Seekers

Key Features Explained

ATS Analysis

AI-Powered Feedback

Mobile-First Design

🔧 Configuration

Puter.js Integration

Environment Variables

🏗️ Project Structure

🚀 Building for Production

🆕 Recent Updates

Version 1.1.0 - Enhanced User Experience

Key Improvements

Mobile Responsiveness

User Experience

Technical Enhancements

🐳 Docker Deployment

Build the Docker image

Run the container

Deploy to cloud platforms

🤝 Contributing

📝 License

🙏 Acknowledgments

📞 Support

📈 Roadmap

Upcoming Features

Planned Improvements

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages