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.

❤️ Other Sponsors

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

Sponsor	Amount (CNY)
@fbitalk	¥20
@yj147	¥10
@someone1128	¥10

📸 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 [email protected]:JOYCEQL/magic-resume.git
cd magic-resume

1. Install dependencies

pnpm install

1. Start development server

pnpm dev

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

OrcaRouter (optional AI provider)

Select OrcaRouter in AI Providers, register through the Magic Resume referral link, then sign in with OrcaRouter or enter your own API key. Fetch the model list, select a model, and test the connection.

This is a partner referral link. Magic Resume may earn a commission on eligible usage by referred sign-ups. Other providers remain available. OAuth sign-in also carries the same referral code for new sign-ups during authorization.

App usage attribution is separate from sign-up referral attribution. Obtain the real app_id from the partner console's Integration page, set VITE_ORCA_APP_ID at build time, and register the exact deployment callback URL, such as https://magicv.art/auth/orcarouter/callback. Local development uses http://localhost:3000/auth/orcarouter/callback. Without an app_id, app usage attribution is not configured. This variable is a public application identifier, never an API key. See the OrcaRouter partner app documentation.

For local development, set VITE_ORCA_APP_ID in .env.local and restart the dev server. For GitHub Actions, add the repository variable under Settings → Secrets and variables → Actions → Variables; both Cloudflare and Docker publishing pass it at build time. Docker Compose reads the build argument from the shell or .env. For a direct build, use docker build --build-arg VITE_ORCA_APP_ID="$VITE_ORCA_APP_ID" -t magic-resume .. This identifier is embedded in the frontend build; setting it only on a running container has no effect. Leave it unset until the real value is available.

📦 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: [email protected]

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

🌟 Support

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