ResumeGen AI 🚀

🤖 AI-Powered Professional Resume Builder

Create stunning, ATS-friendly resumes in minutes with intelligent AI assistance

✨ Features

🎯 Smart Resume Building

• AI-Powered Content Enhancement - Intelligent suggestions for professional summaries, job descriptions, and project details
• Real-time Preview - See your resume as you build it with live updates
• Multiple Templates - Professional, modern designs optimized for ATS systems
• Custom Accent Colors - Personalize your resume with brand colors

🔐 User Management

• Secure Authentication - JWT-based login and registration system
• Personal Dashboard - Manage all your resumes in one place
• Resume Privacy Controls - Make resumes public or private
• Profile Management - Update personal information and preferences

🤖 AI Integration

• Professional Summary Enhancement - AI-powered optimization of career summaries
• Job Description Improvement - Enhance work experience descriptions with industry keywords
• Project Description Refinement - Polish project details for maximum impact
• Resume Parsing - Upload existing resumes and extract structured data

📱 Modern User Experience

• Responsive Design - Works perfectly on desktop, tablet, and mobile
• Intuitive Interface - Clean, user-friendly design with smooth interactions
• Real-time Feedback - Toast notifications and loading states for better UX
• Print-Ready Output - Generate PDF-ready resumes for download and sharing

🖼️ Screenshots

Landing Page

Authentication

Dashboard

Resume Builder

Preview & Export

🛠️ Tech Stack

Frontend

• React 19 - Modern React with latest features
• TypeScript - Type-safe development
• Tailwind CSS 4 - Utility-first styling
• Redux Toolkit - State management
• React Router - Client-side routing
• Lucide React - Beautiful icons
• React Hot Toast - Elegant notifications
• Axios - HTTP client

Backend

• Node.js - JavaScript runtime
• Express.js - Web framework
• TypeScript - Type-safe server development
• MongoDB - NoSQL database
• Mongoose - MongoDB object modeling
• JWT - Authentication tokens
• bcrypt - Password hashing
• Multer - File upload handling
• ImageKit - Image processing and CDN

AI & External Services

• OpenAI API - GPT-powered content enhancement
• ImageKit - Image optimization and storage
• CORS - Cross-origin resource sharing

🚀 Getting Started

Prerequisites

• Node.js (v18 or higher)
• MongoDB (local or cloud instance)
• OpenAI API key
• ImageKit account (for image handling)

Installation

1. Clone the repository

   git clone https://github.com/amaan-ur-raheman/resumegen-ai.git
   cd resumegen-ai

2. Install dependencies

   # Install server dependencies
   cd server
   npm install
   
   # Install client dependencies
   cd ../client
   npm install

3. Environment Setup

   Server (.env)

   PORT=3000
   MONGODB_URI=your_mongodb_connection_string
   JWT_SECRET=your_jwt_secret_key
   OPENAI_API_KEY=your_openai_api_key
   OPENAI_MODEL=gpt-3.5-turbo
   IMAGEKIT_PUBLIC_KEY=your_imagekit_public_key
   IMAGEKIT_PRIVATE_KEY=your_imagekit_private_key
   IMAGEKIT_URL_ENDPOINT=your_imagekit_url_endpoint

   Client (.env)

   VITE_API_URL=http://localhost:3000

4. Start the development servers

   # Start server (from server directory)
   npm run server
   
   # Start client (from client directory)
   npm run dev

5. Access the application

   • Frontend: http://localhost:5173
   • Backend: http://localhost:3000

📁 Project Structure

resumegen-ai/
├── client/                 # React frontend
│   ├── src/
│   │   ├── components/     # Reusable UI components
│   │   ├── pages/          # Page components
│   │   ├── app/            # Redux store configuration
│   │   ├── configs/        # API and configuration files
│   │   ├── types/          # TypeScript type definitions
│   │   └── assets/         # Static assets
│   └── public/             # Public assets
├── server/                 # Node.js backend
│   ├── controllers/        # Route controllers
│   ├── models/             # MongoDB models
│   ├── routes/             # API routes
│   ├── middleware/         # Custom middleware
│   ├── configs/            # Database and service configs
│   ├── constants/          # AI prompts and constants
│   └── types/              # TypeScript type definitions
└── public/                 # Screenshots and assets

🔧 API Endpoints

Authentication

• POST /api/users/register - User registration
• POST /api/users/login - User login
• GET /api/users/data - Get user data
• GET /api/users/resumes - Get user resumes

Resume Management

• POST /api/resumes/create - Create new resume
• PUT /api/resumes/update - Update resume
• DELETE /api/resumes/delete/:resumeId - Delete resume
• GET /api/resumes/get/:resumeId - Get specific resume
• GET /api/resumes/public/:resumeId - Get public resume

AI Enhancement

• POST /api/ai/enhance-pro-sum - Enhance professional summary
• POST /api/ai/enhance-job-desc - Enhance job descriptions
• POST /api/ai/enhance-project-desc - Enhance project descriptions
• POST /api/ai/upload-resume - Parse and extract resume data

📄 Documentation

The codebase is fully documented with JSDoc/TSDoc. Refer to individual files for detailed code-level documentation.

• Client Documentation
• Server Documentation

🎨 Features in Detail

AI-Powered Content Enhancement

The application leverages OpenAI's GPT models to intelligently enhance resume content:

• Professional Summary: Transforms basic career information into compelling professional summaries
• Job Descriptions: Enhances work experience with industry-relevant keywords and quantifiable achievements
• Project Descriptions: Refines project details to highlight technical skills and impact

Resume Builder Interface

• Multi-step Form: Organized sections for personal info, experience, education, projects, and skills
• Real-time Preview: Live preview updates as you edit content
• Template Selection: Choose from 4 professional templates (Classic, Modern, Minimal, Minimal with Image)
• Custom Accent Colors: Personalize your resume with brand colors
• Image Upload: Profile picture support with background removal options

User Dashboard

• Resume Management: Create, edit, delete, and organize multiple resumes
• Privacy Controls: Toggle resume visibility between public and private
• Quick Actions: Duplicate, share, and export resumes with one click

🤝 Contributing

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

📄 License

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

🙏 Acknowledgments

• OpenAI for providing powerful AI capabilities
• ImageKit for image processing and CDN services
• The open-source community for amazing tools and libraries

---

Built with ❤️ by Amaan Ur Raheman

⭐ Star this repo if you found it helpful!