GemiGo 是一个面向非专业用户的前端应用一键部署平台。通过简单的操作，你可以将 GitHub 仓库、ZIP 文件或 HTML 代码快速部署为可访问的 Web 应用。

🌐 在线体验: https://gemigo.io

• 🚀 零配置部署 - 无需了解服务器、域名或 SSL 证书，一键即可上线
• ⚡ 极速上线 - 从代码到线上应用，只需几分钟，无需等待
• 🔒 安全可靠 - 自动部署到 Cloudflare，享受全球 CDN 加速和 DDoS 防护
• 💰 完全免费 - 无隐藏费用，适合个人项目和小团队使用
• 🎨 现代 UI - 美观的界面设计，支持深色模式，体验流畅
• 📊 实时监控 - 实时查看部署日志和状态，问题一目了然
• 🌍 中文支持 - 完整的中文界面和文档，使用更便捷

• 🚀 一键部署 - 支持 GitHub 仓库、ZIP 文件和 HTML 代码部署
• 🔒 安全可靠 - 自动构建和部署到 Cloudflare Pages/R2
• 📊 实时监控 - 通过 SSE 实时查看部署日志和状态
• 🎨 现代 UI - 响应式设计，支持深色模式
• 👥 用户体系 - 支持邮箱、Google、GitHub 登录
• 🌐 应用市场 - 探索和分享其他用户部署的应用

• ✅ 从 GitHub 仓库部署（支持 HTTPS 和 SSH 格式）
• ✅ 上传 ZIP 文件部署
• ✅ 粘贴 HTML 代码直接部署
• ✅ 自动识别构建输出目录（dist/、build/、out/）
• ✅ 自动执行依赖安装和项目构建
• ✅ 部署到 Cloudflare Pages 或 R2 存储
• ✅ 自动修复常见构建问题

• ✅ Dashboard 展示所有项目
• ✅ 实时部署日志流（SSE）
• ✅ 项目状态跟踪（Live / Building / Failed）
• ✅ 深色模式支持
• ✅ 响应式设计

• ✅ 邮箱注册/登录
• ✅ Google OAuth 登录
• ✅ GitHub OAuth 登录
• ✅ 会话管理

• ✅ 探索其他用户部署的应用
• ✅ 按分类和标签筛选
• ✅ 点赞和收藏功能
• ✅ 搜索和排序功能

• Node.js 18+ 和 pnpm
• Cloudflare 账号（用于部署）
• （可选）阿里云服务器（用于 Node 部署服务）

# 克隆仓库
git clone https://github.com/Peiiii/deploy-your-app.git
cd deploy-your-app

# 安装依赖
pnpm install

# 启动所有服务（前端 + API Worker + Node 服务）
pnpm dev

# 或分别启动
pnpm dev:frontend  # 前端开发服务器
pnpm dev:server    # Node 后端服务

详细的环境变量配置请参考 环境变量文档。

最小配置（本地开发）：

1. 创建 server/.env：

DEPLOY_TARGET=local
DASHSCOPE_API_KEY=your_dashscope_key  # 可选，用于 AI 功能

2. 创建 frontend/.env：

VITE_API_BASE_URL=http://localhost:8787/api/v1

完整的文档位于 docs 目录：

• 快速开始指南 - 详细的安装和配置步骤
• 架构文档 - 系统架构和技术栈说明
• API Worker 架构 - API Worker 的详细说明
• 环境变量配置 - 完整的环境变量说明
• 认证设置 - 用户体系和 OAuth 配置
• 部署指南 - 生产环境部署说明
• 功能文档 - 功能详细说明

• 框架: React 19 + TypeScript
• 构建工具: Vite (Rolldown)
• 状态管理: Zustand
• 路由: React Router
• UI: Tailwind CSS + 自定义组件
• 国际化: i18next

• API Worker: Cloudflare Workers (TypeScript)
• 部署服务: Node.js + Express
• 数据库: Cloudflare D1
• 存储: Cloudflare R2 / Pages
• 认证: OAuth 2.0 (Google, GitHub) + Session

• 前端托管: Cloudflare Pages
• API 网关: Cloudflare Workers
• 部署服务: Docker + 阿里云服务器
• CI/CD: GitHub Actions

deploy-your-app/
├── frontend/          # React 前端应用
│   ├── src/
│   │   └── gemini-deploy/
│   │       ├── components/    # UI 组件
│   │       ├── pages/         # 页面
│   │       ├── managers/      # 业务逻辑管理器
│   │       └── services/      # API 服务
│   └── package.json
│
├── workers/           # Cloudflare Workers
│   ├── api/          # API Worker (用户体系、项目 CRUD)
│   ├── r2-gateway/   # R2 存储网关
│   └── screenshot-service/  # 截图服务
│
├── server/           # Node.js 部署服务
│   ├── src/
│   │   ├── modules/  # 业务模块
│   │   ├── routes/   # 路由
│   │   └── common/   # 通用工具
│   └── package.json
│
├── docs/             # 项目文档
├── scripts/          # 部署和工具脚本
└── package.json      # 根 package.json (monorepo)

我们欢迎所有形式的贡献！请查看 贡献指南 了解详细信息。

• 🐛 报告 Bug
• 💡 提出功能建议
• 📝 改进文档
• 🔧 提交代码

本项目采用 MIT 许可证。

感谢所有为这个项目做出贡献的开发者！

• 官方网站: https://gemigo.io
• Issues: GitHub Issues
• Discussions: GitHub Discussions