关于 ShipSwift
ShipSwift 是面向 AI 辅助 iOS 开发的 SwiftUI 组件库和技能目录,提供可复用的界面、动画、图表及应用模块代码。其 MCP 服务允许 AI 工具按需查找和获取技能。
主要功能
- 01浏览 SwiftUI 组件和技能
- 02使用动画与图表组件
- 03获取认证、相机和聊天模块
- 04通过三个工具搜索和读取技能
- 05将源文件复制到 Xcode 项目
适用场景
- 01为 SwiftUI 应用添加动画或图表
- 02构建认证或聊天界面
- 03让 AI 工具查找实现指南
- 04直接使用本地源文件中的组件
MCP 相关
ShipSwift 的 MCP 服务提供 listSkills、getSkill 和 searchSkills 工具,供 AI 客户端发现并获取技能。README 还介绍了连接 https://api.shipswift.app/mcp 的方式。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://api.shipswift.app/mcpclaude mcp add --transport http signerlabs-shipswift https://api.shipswift.app/mcp{"mcpServers":{"signerlabs-shipswift":{"type":"http","url":"https://api.shipswift.app/mcp"}}}在 Cursor 中打开{"servers":{"signerlabs-shipswift":{"type":"http","url":"https://api.shipswift.app/mcp"}}}在 VS Code 中打开{"mcpServers":{"signerlabs-shipswift":{"type":"http","url":"https://api.shipswift.app/mcp"}}}{"mcpServers":{"signerlabs-shipswift":{"serverUrl":"https://api.shipswift.app/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
3| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| category | enum | 否 | 按类别筛选配方。默认值为 'all'。animation | chart | component | module | all |
详细介绍
ShipSwift
什么是 ShipSwift?
只需一条命令,AI 就能获得所需的一切——生产就绪的 SwiftUI 组件、全栈 Skills,以及构建真实应用所需的上下文,无需猜测。
在 shipswift.app 上浏览所有实时 Skills——可搜索的目录、可复制粘贴的源代码和实时预览。
下载 展示应用,即可在设备上预览所有组件。
需要定制应用?我们也能帮你打造。
ShipSwift 能让 AI 完成 80% 的工作。如果你需要完成最后 20%——接入独特功能、品牌和后端——由编写这些 Skills 的团队亲自实现,我们来为你交付。
| ⚡ 48 小时演示 | 提供需求说明后 2 天内,将可运行的原型交付到你的 TestFlight |
| 🚀 4 周交付 | 生产就绪的 iOS 应用,可提交至 App Store |
| 💵 5,000 美元起 | 固定价格,按里程碑计费,无按小时计费的意外费用 |
基于本仓库中的同一组件库构建,因此你仍拥有所有权,并可持续扩展。
获取报价: [email protected] · shipswift.app
快速开始
选项 1:Skills + MCP 服务(推荐)
步骤 1 — 安装 ShipSwift Skills:
npx skills add signerlabs/shipswift-skills
步骤 2 — 连接 MCP 服务,让 AI 获取 Skills:
# Claude Code
claude mcp add --transport http shipswift https://api.shipswift.app/mcp
# Gemini CLI
gemini mcp add --transport http shipswift https://api.shipswift.app/mcp
对于 Cursor、VS Code Copilot、Windsurf 和其他工具,请参阅 Skills 仓库中的 MCP 配置说明。
步骤 3 — 向 AI 提问:
- “添加一个闪光加载动画”
- “使用 Cognito 构建身份验证流程”
- “展示所有图表组件”
选项 2:本地 Skills(无需 MCP)
安装可直接读取本仓库源文件的 Skills——支持离线使用,无需服务端:
npx skills add signerlabs/ShipSwift
之后,AI 就能浏览组件目录并在本地读取源代码。试试这些请求:
- “探索 ShipSwift Skills”
- “添加闪光动画”
- “构建聊天功能”
提示:如果你也连接了 MCP 服务(选项 1),AI 还可访问额外的 Pro Skills(后端指南、合规模板和常见问题文档)。
选项 3:复制文件
- 克隆此仓库
- 将所需文件从
ShipSwift/SWPackage/复制到你的 Xcode 项目中 SWAnimation/、SWChart/和SWComponent/中的每个组件都可独立使用——只需复制相应文件;如有需要,也请复制SWUtil/
运行展示应用
git clone https://github.com/signerlabs/ShipSwift.git
cd ShipSwift
open ShipSwift.xcodeproj
选择模拟器或设备,然后按 Cmd+R 进行构建并运行。
组件
SWAnimation — 动画组件
SwiftUI 动画: Shimmer · TypewriterText · ShakingIcon · GlowSweep · LightSweep · ScanningOverlay · AnimatedMeshGradient · BeforeAfterSlider · OrbitingLogos · FullScreenButton
Canvas 渲染的 3D: DotSphere · CharSphere
Metal 着色器程序化背景: Dots · Starfield · FractalClouds · InkSmoke · LiquidChrome · Plasma · AnimatedLoop
Metal 着色器背景: Metaballs · Halftone · Water · LiquidMetal · NeuroNoise · DotOrbit · Voronoi · SimplexNoise · ColorPanels · SmokeRing · Swirl
共 30 个动画组件——前往 展示应用 查看实时预览。
SWChart — 图表组件
LineChart · BarChart · AreaChart · DonutChart · RingChart · RadarChart · ScatterChart · ActivityHeatmap
SWComponent — UI 组件
展示: FloatingLabels · ScrollingFAQ · RotatingQuote · BulletPointText · GradientDivider · Label · MarkdownText · OnboardingView · OrderView · RootTabView · VideoPlayer 反馈: Alert · Loading · ThinkingIndicator 输入: TabButton · Stepper · AddSheet · SearchBar
SWModule — 多文件框架
- SWAuth — 用户身份验证(Amplify/Cognito、社交登录、邮箱/密码、带国家代码选择器的手机号登录)
- SWCamera — 相机拍摄,支持取景器、变焦、照片选择器,以及使用 Vision 地标跟踪进行人脸检测
- SWPaywall — 使用 StoreKit 2 的订阅付费墙——免费包含 iOS 客户端。全栈技能(后端 + 合规 + 注意事项)→ Pro
- SWChat — 一体化聊天视图,包含消息列表、文本输入,以及可选的语音识别(VolcEngine ASR)
- SWSetting — 设置页面模板,包含语言切换、分享、法律链接和推荐应用
- SWSubjectLifting — 使用 VisionKit ImageAnalysis 移除背景
- SWTikTokTracking — 用于归因跟踪的 TikTok Events API 集成——免费包含 iOS 客户端。全栈技能(后端 + 合规 + 注意事项)→ Pro
SWUtil — 共享实用工具
DebugLog · String/Date/View 扩展 · LocationManager
目录结构
ShipSwift/
├── SWPackage/
│ ├── SWAnimation/ # Animation components
│ ├── SWChart/ # Chart components
│ ├── SWComponent/ # UI components
│ │ ├── Display/ # Display components
│ │ ├── Feedback/ # Feedback components
│ │ └── Input/ # Input components
│ ├── SWModule/ # Multi-file frameworks
│ │ ├── SWAuth/ # Authentication
│ │ ├── SWCamera/ # Camera + face detection
│ │ ├── SWPaywall/ # Subscription paywall
│ │ ├── SWChat/ # Chat + voice input
│ │ ├── SWSetting/ # Settings page
│ │ ├── SWSubjectLifting/ # Background removal
│ │ └── SWTikTokTracking/ # TikTok attribution
│ └── SWUtil/ # Shared utilities
├── View/ # Showcase app views
├── Service/ # App services
└── Component/ # Shared app components
命名约定
所有类型均使用 SW 前缀(例如,SWAlertManager、SWStoreManager)。
视图修饰符使用小写 .sw 前缀(例如,.swAlert()、.swPageLoading()、.swPrimary)。
依赖规则
SWUtil ← no dependencies on other SWPackage directories
SWAnimation ← may depend on SWUtil only
SWChart ← may depend on SWUtil only
SWComponent ← may depend on SWUtil only
SWModule ← may depend on SWUtil and SWComponent
技能
ShipSwift 提供免费和 Pro 技能——每项技能均包含完整的 SwiftUI 源代码、实现步骤和最佳实践。你的 AI 助手可以按需获取任何技能。
| 类别 | 示例 |
|---|---|
| 动画 | Shimmer、Typewriter、Orbiting Logos |
| 图表 | Line、Bar、Donut、Radar、Heatmap |
| 组件 | Alert、Onboarding、Stepper、FAQ |
| 模块 | Auth、Camera、Chat、Setting、Infra CDK、Subscription*、TikTok Tracking*、Export & Share* |
* Pro 技能——包含完整后端、合规模板和注意事项指南。即将推出:推送通知、分析仪表板。
可使用三个工具:listSkills、getSkill、searchSkills。
前往 shipswift.app 了解更多 · 技能仓库:signerlabs/shipswift-skills
免费版与 Pro 版
所有 iOS 客户端代码均以 MIT 许可证开源。Pro 技能提供从原型走向生产所需的一切。
| 免费版(开源) | Pro 技能 | |
|---|---|---|
| iOS 客户端代码 | 完整源代码 | 增强版 |
| 后端实现 | — | Hono 路由、数据库架构、webhook |
| 集成指南 | — | 端到端设置清单 |
| 合规模板 | — | 隐私清单、App Store 标签 |
| 已知注意事项 | — | 每项技能 10+ 条经实战验证的提示 |
详情请参阅定价。
技术栈
- SwiftUI + Swift
- StoreKit 2
- Amplify SDK(Cognito)
- AVFoundation + Vision
- SpriteKit
- VolcEngine ASR
贡献
欢迎贡献!请按照以下步骤操作:
- Fork 此仓库
- 创建功能分支(
git checkout -b feature/amazing-feature) - 提交更改(
git commit -m 'Add amazing feature') - 推送到该分支(
git push origin feature/amazing-feature) - 发起 Pull Request
代码风格
- 所有注释和文档均使用英语
- 遵循上述命名约定、依赖规则和自包含要求
许可证
本项目采用 MIT 许可证,详情请参阅 LICENSE 文件。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。
