Magic Resume

Magic Resume 是一款基于现代 Web 技术栈构建的开源简历编辑器。它摒弃了传统简历工具的僵化模板，通过 TanStack Start 和 Motion 提供了流畅的动画体验和实时的可视化编辑能力。无论是求职还是个人品牌展示，它都能帮助用户轻松创建专业且极具设计感的简历。

核心特性

• 极致性能与体验：基于 TanStack Start 全栈框架，提供快速的页面加载和 seamless 的路由切换。
• 丝滑交互动画：集成 Motion 库，为界面元素添加细腻的过渡效果，让编辑过程充满愉悦感。
• 高度可定制：
  • 自定义主题：支持调整配色方案，打造个人品牌风格。
  • 深色模式：完美适配系统偏好，保护视力。
• 富文本编辑：基于 Tiptap 构建强大的内容编辑器，支持丰富的排版格式。
• 实时预览与自动保存：左侧编辑，右侧实时渲染；数据自动持久化，无需担心丢失进度。
• 一键导出 PDF：生成打印级质量的 PDF 文件，方便投递。
• 本地优先存储：数据存储在用户本地（硬盘级存储），保障隐私安全。

技术栈

Magic Resume 采用了当前前端领域最前沿的技术组合：

快速开始

1. 克隆项目

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

2. 安装依赖

推荐使用 pnpm 进行包管理：

pnpm install

3. 启动开发服务器

pnpm dev

浏览器访问：http://localhost:3000

4. 构建生产版本

pnpm build

Docker 部署

如果你希望快速部署自己的实例，可以使用 Docker Compose。

前提条件：已安装 Docker 和 Docker Compose。

启动命令：

docker compose up -d

这将自动构建应用镜像并在后台启动容器。

开源协议与商业授权

本项目采用 Apache 2.0 开源协议，但附带严格的商业使用限制：

• ✅ 个人免费：仅限个人非商业目的使用（如个人学习、制作个人简历、技术交流）。
• ❌ 商用需授权：
  • 严禁未经授权将本项目作为 SaaS/PaaS 服务向公众提供以获取利益。
  • 严禁在企业商业运营中直接使用。
  • 严禁进行二次商业化开发（无论是否修改源代码）。
  • 任何上述商业行为均须事先获取官方的商业授权。