MCP 服务器

ShipSwift

AI-native SwiftUI component library with full-stack recipes — connect via MCP for instant access.

README

ShipSwift

AI-native SwiftUI component library — production-ready code that LLMs can use to build real apps.

Quick Start · Components · Directory Structure · Recipes · Contributing

</div>

What is ShipSwift?

One command gives your AI everything it needs — production-ready SwiftUI components, full-stack recipes, and the context to build real apps without guessing. Check more MCP recipes.

Download the Showcase App to preview every component on your device.

Quick Start

Option 1: Skills + Recipe Server (Recommended)

Step 1 — Install ShipSwift Skills:

npx skills add signerlabs/shipswift-skills

Step 2 — Connect the recipe server so your AI can fetch recipes:

# 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

For Cursor, VS Code Copilot, Windsurf, and other tools, see the Skills repo for MCP setup.

Step 3 — Ask your AI:

"Add a shimmer loading animation"
"Build an authentication flow with Cognito"
"Show me all chart components"

Option 2: File Copy

Clone this repository
Copy the files you need from ShipSwift/SWPackage/ into your Xcode project
Each component in SWAnimation/, SWChart/, and SWComponent/ is self-contained — just copy the file and SWUtil/ if needed

Run the Showcase App

git clone https://github.com/signerlabs/ShipSwift.git
cd ShipSwift
open ShipSwift.xcodeproj

Select a simulator or device, then press Cmd+R to build and run.

Components

SWAnimation — Animation Components

BeforeAfterSlider · TypewriterText · ShakingIcon · Shimmer · GlowSweep · LightSweep · ScanningOverlay · AnimatedMeshGradient · OrbitingLogos

SWChart — Chart Components

LineChart · BarChart · AreaChart · DonutChart · RingChart · RadarChart · ScatterChart · ActivityHeatmap

SWComponent — UI Components

Display: FloatingLabels · ScrollingFAQ · RotatingQuote · BulletPointText · GradientDivider · Label · OnboardingView · OrderView · RootTabView Feedback: Alert · Loading · ThinkingIndicator Input: TabButton · Stepper · AddSheet

SWModule — Multi-File Frameworks

SWAuth — User authentication (Amplify/Cognito, social login, email/password, phone sign-in with country code picker)
SWCamera — Camera capture with viewfinder, zoom, photo picker, and face detection with Vision landmark tracking
SWPaywall — Subscription paywall using StoreKit 2 — iOS client included free. Full-stack recipe (backend + compliance + pitfalls) → Pro
SWChat — All-in-one chat view with message list, text input, and optional voice recognition (VolcEngine ASR)
SWSetting — Settings page template with language switch, share, legal links, recommended apps
SWSubjectLifting — Background removal using VisionKit ImageAnalysis
SWTikTokTracking — TikTok Events API integration for attribution tracking — iOS client included free. Full-stack recipe (backend + compliance + pitfalls) → Pro

SWUtil — Shared Utilities

DebugLog · String/Date/View extensions · LocationManager

Directory Structure

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

Naming Convention

All types use the SW prefix (e.g., SWAlertManager, SWStoreManager). View modifiers use .sw lowercase prefix (e.g., .swAlert(), .swPageLoading(), .swPrimary).

Dependency Rules

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

Recipes

ShipSwift provides free and pro recipes via Skills — each recipe includes complete SwiftUI source code, implementation steps, and best practices. Your AI assistant can retrieve any recipe on demand.

Category	Examples
Animation	Shimmer, Typewriter, Orbiting Logos
Chart	Line, Bar, Donut, Radar, Heatmap
Component	Alert, Onboarding, Stepper, FAQ
Module	Auth, Camera, Chat, Setting, Infra CDK, Subscription, TikTok Tracking, Export & Share*

* Pro recipes — includes full backend, compliance templates, and pitfall guides. Coming soon: Push Notifications, Analytics Dashboard.

Three tools are available: listRecipes, getRecipe, searchRecipes.

Learn more at shipswift.app · Skills repo: signerlabs/shipswift-skills

Free vs Pro

All iOS client code is open-source under the MIT license. Pro recipes add everything you need to go from prototype to production.

	Free (Open Source)	Pro Recipe
iOS client code	Full source	Enhanced version
Backend implementation	—	Hono routes, DB schema, webhooks
Integration guides	—	End-to-end setup checklists
Compliance templates	—	Privacy manifest, App Store labels
Known pitfalls	—	10+ battle-tested tips per recipe

More Pro recipes coming soon: Push Notifications, Analytics Dashboard.

See pricing for details.

Tech Stack

SwiftUI + Swift
StoreKit 2
Amplify SDK (Cognito)
AVFoundation + Vision
SpriteKit
VolcEngine ASR

Contributing

Contributions are welcome! Please follow these steps:

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

Code Style

All comments and documentation in English
All types use the SW prefix
Each file in SWAnimation/, SWChart/, and SWComponent/ must be self-contained
Follow existing code patterns and naming conventions