✨ Magic Resume ✨

简体中文 | English

Magic Resume is a modern online resume editor that makes creating professional resumes simple and enjoyable. Built with TanStack Start and Framer Motion, it supports real-time preview and custom themes.

📸 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

• TanStack Start
• TypeScript
• Motion
• Tiptap
• Tailwind CSS
• Zustand
• Shadcn/ui
• Lucide Icons

🚀 Quick Start

1. Clone the project

git clone git@github.com:JOYCEQL/magic-resume.git
cd magic-resume

2. Install dependencies

pnpm install

3. Start development server

pnpm dev

4. Open browser and visit http://localhost:3000

📦 Build and Deploy

pnpm build

AI provider networking

Cloudflare Workers use the platform's native fetch and do not need an application-level proxy. For Node.js or Docker deployments in regions that cannot directly reach OpenAI, Gemini, or Anthropic, set AI_PROXY_URL. HTTPS_PROXY and HTTP_PROXY are also supported as fallbacks.

AI_PROXY_URL=http://127.0.0.1:7890

DeepSeek, Qwen, and Doubao continue to use a direct connection.

🐳 Docker Deployment

Docker Compose

1. Ensure you have Docker and Docker Compose installed

2. Run the following command in the project root directory:

docker compose up -d

This will:

• Automatically build the application image
• Start the container in the background

📝 License and Usage Restrictions

The source code of this project is released under the Apache 2.0 license with an additional non-commercial use restriction:

• Free for Personal Use: Free to use purely for personal, non-commercial purposes (e.g., personal learning, creating your own resume).
• Commercial Use Prohibited: The project may not be used for any commercial purpose, including providing it as a paid or profit-generating service (such as SaaS/PaaS), enterprise commercial operations, resale, or secondary commercial development, regardless of whether the source code has been modified.

Please see the LICENSE file for detailed terms.

🗺️ Roadmap

• AI-assisted writing
• Multi-language support
• Support for more resume templates
• Support for more export formats
• Import PDF, Markdown, etc.
• Custom model
• Auto one page
• Online resume hosting

📈 Star History

📞 Contact

You can follow the latest updates via:

• Author: Siyue

• X: @GuangzhouY81070

• Discord: Join our community https://discord.gg/9mWgZrW3VN

• Email: 18806723365@163.com

• Project Homepage: https://github.com/JOYCEQL/magic-resume

🌟 Support

If you find this project helpful, please give it a star ⭐️

❤️ Sponsors

Sponsors

If you sponsored this project but are not listed here, please contact me.