ResumeLab

简体中文 | English

ResumeLab is a modern resume builder focused on speed, clarity, and a polished editing experience. It helps you write, refine, preview, and export professional resumes with less friction.

This project is forked from Magic Resume and is now organized as a frontend/backend separated monorepo, with a standalone Hono API backend for AI-powered capabilities.

Fork Notice

This project is forked from Magic Resume. The original project's license and additional commercial restrictions in LICENSE continue to apply to the upstream codebase.

Screenshots

Features

• 🚀 Built with TanStack Start
• 💫 Smooth animations (Framer Motion)
• 🎨 Custom theme support
• 📱 Responsive design
• 🌙 Dark mode
• 📤 Export to PDF
• 🔄 Real-time preview
• 💾 Auto-save
• 🔒 Local storage

Tech Stack

• apps/web: TanStack Start, Vite, React, TypeScript, Tailwind CSS, Zustand, TipTap
• apps/backend: Hono, Node.js, TypeScript
• Workspace: pnpm

Project Structure

.
├── apps
│   ├── web        # frontend app
│   └── backend    # Hono API service
├── docker-compose.yml
├── package.json
└── pnpm-workspace.yaml

Quick Start

1. Clone the project

git clone git@github.com:1111-stu/resume-lab.git
cd resume-lab

2. Install dependencies

pnpm install

3. Prepare env files

cp apps/web/.env.example apps/web/.env
cp apps/backend/.env.example apps/backend/.env

4. Start both apps

pnpm dev

5. Open:

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

Development Commands

Run both apps:

pnpm dev

Run frontend only:

pnpm dev:web

Run backend only:

pnpm dev:backend

This currently builds the frontend only.

Environment Variables

Frontend apps/web/.env.example:

VITE_API_BASE_URL=http://localhost:3000
FONTCONFIG_PATH=/var/task/fonts

Backend apps/backend/.env.example:

PORT=3000
CORS_ORIGIN=http://localhost:5137

Notes:

• The frontend reads VITE_API_BASE_URL at runtime to call the standalone backend.
• AI provider credentials are currently configured in the frontend settings and sent to backend API routes when needed.

API Overview

Current backend routes include:

• GET /health
• POST /v1/resume/grammar
• POST /v1/resume/polish
• POST /v1/resume/import
• GET /v1/media/image-proxy

The grammar check flow is the first fully migrated frontend-to-backend example in this architecture.

Project Direction

ResumeLab will continue to be maintained as an open-source project. The next stage will focus on improving the resume editing experience and expanding AI-assisted features, including interview question prediction, resume expansion, and self-introduction generation.

Deployment

This project is designed for separated deployment:

• apps/web can be deployed as the frontend service
• apps/backend can be deployed as the API service

Each app has its own Dockerfile:

• apps/web/Dockerfile
• apps/backend/Dockerfile

For local or simple self-hosting, you can also use Docker Compose:

docker compose up -d

Default ports:

• Web: 5137
• Backend: 3000

License and Commercial Use

The source code of this project is open-sourced under the Apache 2.0 license, but with strict commercial use restrictions:

• Free for Personal Use: Free to use purely for personal, non-commercial purposes.
• Commercial License Required: Unauthorized commercial use is prohibited. If you provide it as a service, use it in commercial operations, or perform secondary commercial development, you must obtain commercial authorization.

Please read LICENSE for the detailed terms.

Roadmap

• AI-assisted writing
• Multi-language support
• Custom model configuration
• Auto one page
• Resume diagnosis
• Interview question prediction
• Resume expansion
• Self-introduction generation
• More resume templates
• More export formats
• Import PDF / Markdown / more formats
• Online resume hosting

Star History

Support

If ResumeLab helps you, a star is always appreciated.