ShipSwift

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

Quick Start · Components · Directory Structure · MCP Recipes · Contributing

---

Quick Start

Option 1: MCP Integration (Recommended)

Connect ShipSwift via MCP so your AI assistant can access all components and recipes instantly:

Claude Code

claude mcp add --transport http shipswift https://api.shipswift.app/mcp

Cursor Add to .cursor/mcp.json:

{
  "mcpServers": {
    "shipswift": {
      "url": "https://api.shipswift.app/mcp"
    }
  }
}

Windsurf Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "shipswift": {
      "serverUrl": "https://api.shipswift.app/mcp"
    }
  }
}

Option 2: File Copy

1. Clone this repository
2. Copy the files you need from ShipSwift/SWPackage/ into your Xcode project
3. 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 — 9 Animation Components

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

SWChart — 8 Chart Components

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

SWComponent — 15 UI Components

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

SWModule — 5 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
• 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

SWUtil — Shared Utilities

DebugLog · String/Date/View extensions · LocationManager

---

Directory Structure

ShipSwift/
├── SWPackage/
│   ├── SWAnimation/          # Animation components (9 files)
│   ├── SWChart/              # Chart components (8 files)
│   ├── SWComponent/          # UI components (15 files)
│   │   ├── Display/          #   Display components (9)
│   │   ├── Feedback/         #   Feedback components (3)
│   │   └── Input/            #   Input components (3)
│   ├── SWModule/             # Multi-file frameworks (5 modules)
│   │   ├── SWAuth/           #   Authentication (4 files)
│   │   ├── SWCamera/         #   Camera + face detection (4 files)
│   │   ├── SWPaywall/        #   Subscription paywall (2 files)
│   │   ├── SWChat/           #   Chat + voice input (4 files)
│   │   └── SWSetting/        #   Settings page (1 file)
│   └── SWUtil/               # Shared utilities (5 files)
├── View/                     # Showcase app views
└── 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

---

MCP Recipes

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

Category	Count	Examples
Animation	9	Shimmer, Typewriter, Orbiting Logos
Chart	8	Line, Bar, Donut, Radar, Heatmap
Component	15	Alert, Onboarding, Stepper, FAQ
Module	6	Auth, Camera, Chat, Setting, Subscription, Infra CDK

Three MCP tools are available: listRecipes, getRecipe, searchRecipes.

Learn more at shipswift.app

---

Tech Stack

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

---

Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. 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

---

License

This project is licensed under the MIT License — see the LICENSE file for details.

---

Made with ❤️ by SignerLabs