Skip to content

Repository files navigation

📝 ResuMint

Create professional, ATS-friendly resumes with AI-powered content suggestions and 40+ templates.

License: MIT Node 18+ Python 3.10+ FastAPI React Vite

📖 Docs · 🚀 Deploy · ⭐ Star on GitHub


Why ResuMint

Most resume builders are either too basic (just a form → PDF) or too expensive ($20+/month for features that should be free).

ResuMint is different:

  • 40+ professionally designed templates — from minimal to creative
  • Real-time ATS scoring — know if your resume will pass automated filters
  • AI content suggestions — bullet rewrites, skill recommendations, summary generation
  • Live preview — see changes instantly as you type
  • Fully open source — MIT licensed, self-hostable, no vendor lock-in

✨ Features

Feature Description
40+ Templates London Classic, Modern Bold, Berlin Clean, Stockholm Minimal, and 36 more
ATS Scoring Real-time score (0-100) with actionable feedback
AI Suggestions Rewrite bullets, add metrics, suggest skills, generate summaries
Live Preview A4-sized live preview with zoom, fit, and 1:1 modes
Drag & Drop Reorder sections with @dnd-kit
Template Morphing Smooth animated transitions between templates
Export PDF, DOCX, TXT with quality presets
Share Links Generate private view-only links
Mobile Responsive Edit on any device

🚀 Quick Start

Prerequisites: Node.js 18+ · Python 3.10+ · npm

# 1. Clone
git clone https://github.com/niranjannie/ResumeMint.git
cd ResumeMint

# 2. Start backend
cd backend
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
uvicorn main:app --reload --port 8000

# 3. Start frontend (new terminal)
cd ../frontend
npm install
cp .env.example .env
npm run dev

Open http://localhost:5173

Full setup: docs/SETUP.md


🏗️ Architecture

ResumeMint/
├── frontend/              # React 19 + Vite + Tailwind CSS
│   ├── src/
│   │   ├── products/resume/   # Resume builder core
│   │   ├── pages/             # Login, Register, Settings
│   │   └── lib/api.ts         # API client
├── backend/               # FastAPI + SQLAlchemy
│   ├── main.py            # App entry
│   ├── auth.py            # JWT + bcrypt
│   ├── models.py          # Database models
│   └── routers/           # API routes
├── e2e-tests/             # Playwright E2E tests
└── docs/                  # Setup, deployment, architecture

Stack:

  • Frontend: React 19, Vite, Tailwind CSS, shadcn/ui, Framer Motion
  • Backend: FastAPI, SQLAlchemy, PostgreSQL/SQLite, slowapi
  • Auth: JWT tokens, bcrypt password hashing
  • Testing: Playwright E2E (50+ tests, 40 template coverage)

🧪 Testing

# E2E tests
cd e2e-tests
npm install
npx playwright test

Current coverage: 50 tests, all 40 templates validated.


🚀 Deployment

Deploy to production in minutes:


🤝 Contributing

We welcome contributions!

Priority areas: More templates · Accessibility · Mobile UX · Translations

See CONTRIBUTING.md


📄 License

MIT License — free to use, modify, and commercialize.


🙏 Acknowledgments

  • Built with FastAPI and React
  • Resume templates inspired by top hiring platforms
  • E2E testing powered by Playwright

About

ResumeMint - Open Source Resume Builder

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages