shipme template

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_ID

2.等待安装（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）

1. 访问https://github.com/settings/developers
2. 点击“新建OAuth应用程序”
3. 设置：

- 主页网址：您的Netlify URL - 回调URL: https://YOUR_PROJECT.supabase.co/auth/v1/callback

1. 在Claude提示时复制客户端ID和密码

自定义域（可选）

1. 在Netlify仪表板中添加域
2. 更新DNS记录
3. 更新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仪表板中手动验证：站点设置→ 环境变量

配置期间会发生什么

克劳德代码将：

1. 读取配置 -了解您的项目要求
2. 创建Supabase项目 -约1-2分钟
3. 运行迁移 -设置数据库架构（约10秒）
4. 配置身份验证 -设置OAuth提供程序（手动步骤）
5. 构建应用程序 -创建生产构建（约30-60秒）
6. 创建Netlify网站 -设置主机（约10秒）
7. 设置环境变量 -配置所有机密（约20秒）
8. 部署 -投入生产（约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基础设施代码获得了麻省理工学院的许可。