ShipMe入门模板
这是一个用于创建项目的模板存储库 ShipMe.dev -通过GitHub Codespace实现自动化基础设施配置。
里面有什么
此模板包括：
- GitHub代码空间配置 -预配置的开发环境
- MCP（模型上下文协议）服务器 -基础设施自动化工具
- GitHub MCP-存储库管理 - Supabase MCP-数据库和身份验证 - Netlify MCP-托管和部署
- Claude代码集成 -AI驱动的DevOps助手
- 项目配置 -您在中的项目设置
.shipme/project.json
快速开始
1.在代码空间中打开
点击绿色的“代码”按钮→ “代码空间”→ “在main上创建代码空间”
或者使用此直接链接格式：
https://github.com/codespaces/new?repo=YOUR_REPO_ID2.等待安装（2-3分钟）
代码空间将自动：
- 安装Node.js和依赖项
- 构建MCP服务器
- 使用基础设施工具设置Claude代码
- 显示设置完成消息
3.验证服务
# Authenticate GitHub CLI
gh auth login
# Add Supabase & Netlify tokens as Codespace secrets:
# Settings → Secrets → New secret
# - SUPABASE_ACCESS_TOKEN (from https://supabase.com/dashboard/account/tokens)
# - NETLIFY_AUTH_TOKEN (from https://app.netlify.com/user/applications)4.开始配置
在终端中，让Claude Code配置您的基础设施：
@claude Read my project configuration and provision the infrastructure克劳德将：
- 创建您的Supabase数据库
- 运行数据库迁移
- 配置身份验证（如果需要）
- 部署到Netlify
- 设置所有环境变量
什么被配置
基于中的堆栈配置 .shipme/project.json:
数据库（Supabase）
- PostgreSQL数据库
- 自动生成REST API
- 实时订阅
- 身份验证系统
- 行级安全（RLS）策略
主机（Netlify）
- CDN部署
- 自动HTTPS
- 环境变量
- 从Git持续部署
身份验证（可选）
- GitHub OAuth
- 谷歌OAuth
- 电子邮件/密码
- 魔术链接
项目结构
.
├── .devcontainer/
│ ├── devcontainer.json # Codespace configuration
│ └── post-create.sh # Setup script
├── .shipme/
│ ├── project.json # Your project config (auto-generated)
│ └── claude-instructions.md # Instructions for Claude Code
├── mcp-servers/ # Infrastructure automation tools
│ ├── github/ # GitHub operations
│ ├── supabase/ # Database operations
│ ├── netlify/ # Deployment operations
│ └── shared/ # Shared utilities
├── src/ # Your application code (add your framework here)
└── README.md # This file添加您的应用程序代码
这是一个模板-添加你的Next.js、React或其他框架代码：
# For Next.js:
npx create-next-app@latest . --typescript --tailwind --app
# For Vite + React:
npm create vite@latest . -- --template react-ts
# Or copy your existing code确保更新 package.json 使用适当的构建脚本：
npm run build-应生成生产构建npm start-应启动生产服务器
手动步骤
有些步骤需要手动操作：
GitHub OAuth应用程序（如果使用GitHub auth）
- 访问https://github.com/settings/developers
- 点击“新建OAuth应用程序”
- 设置：
- 主页网址：您的Netlify URL - 回调URL: https://YOUR_PROJECT.supabase.co/auth/v1/callback
- 在Claude提示时复制客户端ID和密码
自定义域（可选）
- 在Netlify仪表板中添加域
- 更新DNS记录
- 更新OAuth回调URL
环境变量
Claude在Netlify中自动配置这些：
# Supabase (auto-configured)
NEXT_PUBLIC_SUPABASE_URL=https://xxx.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=eyJhbG...
SUPABASE_SERVICE_ROLE_KEY=eyJhbG...
# Authentication (if configured)
GITHUB_ID=your_client_id
GITHUB_SECRET=your_client_secret
# Security
NEXTAUTH_SECRET=auto_generated_random_string故障排除
“未找到MCP服务器”
运行： cd mcp-servers && npm run build
“身份验证失败”
- 检查令牌是否设置为代码空间机密
- 验证令牌是否未过期
- 跑
gh auth status检查GitHub身份验证
“Supabase项目创建缓慢”
- 正常-配置需要30-60秒
- 克劳德会自动等待
“未设置某些环境变量”
- 有些人可能会在Netlify上默默地失败
- 在Netlify仪表板中手动验证：站点设置→ 环境变量
配置期间会发生什么
克劳德代码将：
- 读取配置 -了解您的项目要求
- 创建Supabase项目 -约1-2分钟
- 运行迁移 -设置数据库架构（约10秒）
- 配置身份验证 -设置OAuth提供程序（手动步骤）
- 构建应用程序 -创建生产构建（约30-60秒）
- 创建Netlify网站 -设置主机（约10秒）
- 设置环境变量 -配置所有机密（约20秒）
- 部署 -投入生产（约2-5分钟）
总时间：8-15分钟
建筑
GitHub Codespace
↓
Claude Code (AI orchestrator)
↓
MCP Servers (infrastructure tools)
↓
Cloud Services (Supabase, Netlify, etc.)
↓
Your Application (LIVE!)支持
- ShipMe文档: https://shipme.dev/docs
- MCP协议: https://modelcontextprotocol.io
- 问题: https://github.com/YOUR_ORG/shipme.dev/issues
由...创建
此项目是通过以下方式创建的 ShipMe.dev -借助人工智能驱动的基础设施自动化，运输速度更快。
许可证
你的代码，你的许可证。ShipMe基础设施代码获得了麻省理工学院的许可。