Skip to content
BranchesTags

Repository files navigation

✨ Resuvio-AI - Open-Source AI Resume Builder & Career Assistant ✨

🌐 Live Demo • 🐞 Report Bug • 💡 Request Feature • 💬 Discussions • 📚 Documentation

License React TypeScript Vite Tailwind CSS Express Firebase Gemini AI CI Code Style


English | हिंदी | Español

Resuvio-AI is a free and open-source AI Resume Builder, ATS Resume Optimizer, Resume Analyzer, Job Matching Platform, and AI Cover Letter Generator powered by Google Gemini. It helps job seekers create ATS-friendly resumes, analyze resume quality, match resumes with job descriptions, generate personalized cover letters, and streamline interview preparation using AI.

📸 Screenshots

Dashboard Resume Builder AI Analysis Job Matching
Dashboard Builder Analysis Job Match

✨ Features

  • 🚀 Modern Stack: React 18, Vite, TypeScript, Tailwind CSS, shadcn/ui
  • 🧠 AI-Powered Analysis: Resume scoring & feedback with Gemini 2.5 Flash
  • 📄 Smart Parsing: PDF/DOCX upload with text extraction
  • 🎯 Job Matching: Skill gap analysis & ATS compatibility scoring
  • ✍️ Cover Letters: Personalized generation for any job application
  • 🎨 Resume Builder: Drag-and-drop, multiple templates, real-time preview
  • 🌙 Dark Mode: Full theme support with persistence
  • 💳 Credits System: Usage tracking with Razorpay payments
  • 🔒 Secure Auth: Firebase Authentication (Email/Password, Google OAuth)
  • 📱 Responsive: Mobile-first design, works everywhere
  • ♿ Accessible: WCAG 2.1 AA compliant components

🛠️ Tech Stack

Category Technologies
Frontend React 18, Vite 5, TypeScript 5, Tailwind CSS 3, shadcn/ui, React Router 6, TanStack Query 5, React Hook Form 7, Zod, Framer Motion, Lucide React
Backend Node.js 20, Express 5, TypeScript 5, Firebase Admin SDK, Google Generative AI, Multer, pdf-parse, Mammoth, Razorpay
Database Cloud Firestore (NoSQL, real-time, auto-scaling)
Auth Firebase Authentication (client + admin SDK)
AI Google Gemini 2.5 Flash (configurable)
Payments Razorpay (subscriptions + one-time)
Testing Vitest, React Testing Library, Jest, Supertest
CI/CD GitHub Actions (lint, test, build, deploy)
Hosting Vercel/Netlify (frontend), Cloud Run/Fly.io (backend)

📚 Documentation

Document Description
Getting Started Installation, setup, and running locally
Architecture System design, data flow, and technical decisions
API Reference Complete REST API documentation
Deployment Production deployment guides for all platforms
Contributing Development workflow, coding standards, PR process
Security Security policy and vulnerability reporting
Code of Conduct Community guidelines
Support Help channels and troubleshooting
Changelog Version history and release notes

🚀 Quick Start

Prerequisites

  • Node.js 20.x LTS
  • npm 10.x (or pnpm/yarn)
  • Firebase project
  • Google AI Studio API key

1. Clone & Install

git clone https://github.com/piyushh62/Resuvio-AI.git
cd Resuvio-AI

# Install all dependencies
cd frontend && npm install && cd ..
cd backend && npm install && cd ..

2. Configure Environment

Frontend (frontend/.env)

VITE_API_BASE_URL=http://localhost:3001
VITE_FIREBASE_API_KEY=your-api-key
VITE_FIREBASE_AUTH_DOMAIN=your-project.firebaseapp.com
VITE_FIREBASE_PROJECT_ID=your-project-id
VITE_FIREBASE_STORAGE_BUCKET=your-project.appspot.com
VITE_FIREBASE_MESSAGING_SENDER_ID=123456789
VITE_FIREBASE_APP_ID=1:123456789:web:abcdef

Backend (backend/.env)

PORT=3001
FRONTEND_URL=http://localhost:8080
GEMINI_API_KEY=your-gemini-api-key
GEMINI_MODEL=gemini-2.5-flash
# Choose one Firebase auth method:
GOOGLE_APPLICATION_CREDENTIALS=./serviceAccountKey.json
# OR
FIREBASE_SERVICE_ACCOUNT_JSON={"type":"service_account",...}
# OR
FIREBASE_SERVICE_ACCOUNT_BASE64=base64-encoded-json

3. Start Development Servers

# Terminal 1: Backend (port 3001)
cd backend && npm run dev

# Terminal 2: Frontend (port 8080)
cd frontend && npm run dev

4. Open Application

Visit http://localhost:8080 in your browser.

5. Optional: Firebase Emulators

# Install Firebase CLI
npm install -g firebase-tools

# Start emulators (Firestore, Auth, Functions)
firebase emulators:start --project=demo-resuvio

📦 Build & Deploy

Frontend

cd frontend
npm run build          # Output: dist/
npm run preview        # Preview production build

Backend

cd backend
npm run build          # Output: dist/
npm start              # Run production build

Docker

# Frontend
docker build -t resuvio-frontend ./frontend

# Backend
docker build -t resuvio-backend ./backend

# Run with docker-compose
docker-compose up -d

Deployment Platforms

Platform Frontend Backend
Vercel ✅ Recommended ❌
Netlify ✅ Recommended ❌
Cloud Run ✅ ✅ Recommended
Fly.io ✅ ✅
Render ✅ ✅
VPS (PM2) ❌ ✅

See Deployment Guide for detailed instructions.

🧪 Testing

# Frontend tests
cd frontend
npm run test           # Unit tests
npm run test:ui        # Visual test UI
npm run test:coverage  # Coverage report

# Backend tests
cd backend
npm test               # Unit + integration tests
npm test -- --coverage # With coverage

🤝 Contributing

We welcome contributions! Please read our Contributing Guide for:

  • Development setup
  • Coding standards
  • Commit message convention (Conventional Commits)
  • Pull request process
  • Testing guidelines

Quick Contribution Steps

# 1. Fork & clone
git clone https://github.com/piyushh62/Resuvio-AI.git

# 2. Create feature branch
git checkout -b feature/amazing-feature

# 3. Make changes & commit
git commit -m "feat: add amazing feature"

# 4. Push & create PR
git push origin feature/amazing-feature

🗺️ Roadmap

  • AI-assisted Resume Writing
  • Cover Letter Generation
  • Job Matching Engine
  • Resume Builder with Templates
  • Credits & Payment System
  • Multi-language Support (i18n)
  • Export to DOCX format
  • More modern resume templates
  • Portfolio / Link-in-bio generation
  • Interview preparation module
  • Browser extension for LinkedIn/Indeed
  • API for third-party integrations

📈 Star History

Star History Chart

📄 License

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

🔒 Security

For security vulnerabilities, please see our Security Policy and report via GitHub Security Advisories or email piyushsenjaliya1999@gmail.com.

📞 Support & Community

🙏 Acknowledgments

⭐ Support the Project

If you find Resuvio-AI helps you land your dream job, please consider:

  • ⭐ Starring the repository
  • 🐛 Reporting bugs
  • 💡 Suggesting features
  • 🤝 Contributing code
  • 📢 Sharing with others
  • ☕ Sponsoring
Made with ❤️ by the Resuvio-AI team
Empowering job seekers worldwide with AI

About

Resuvio AI – AI-powered Resume Builder & ATS Optimizer that creates professional resumes, analyzes ATS compatibility, and helps job seekers increase interview success rates.

resuvio-ai.vercel.app

Topics

aiai-resume-builderartificial-intelligenceats-resumecareercover-letter-generatorgpthacktoberfestjavascriptjob-searchjob-seekerllmnodejsopen-sourcepdf-generatorreactresumeresume-builder

Resources

Readme
MIT license

Code of conduct

Code of conduct

Contributing

Contributing

Security policy

Security policy
Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages