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.
- 🚀 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
- TanStack Start
- TypeScript
- Motion
- Tiptap
- Tailwind CSS
- Zustand
- Shadcn/ui
- Lucide Icons
- Clone the project
git clone git@github.com:JOYCEQL/magic-resume.git
cd magic-resume- Install dependencies
pnpm install- Start development server
pnpm dev- Open browser and visit
http://localhost:3000
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.
pnpm buildCloudflare 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:7890DeepSeek, Qwen, and Doubao continue to use a direct connection.
-
Ensure you have Docker and Docker Compose installed
-
Run the following command in the project root directory:
docker compose up -dThis will:
- Automatically build the application image
- Start the container in the background
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.
- 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
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
If you find this project helpful, please give it a star ⭐️
