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: Local Skills (No MCP Required)

Install skills that read source files directly from this repo — works offline, no server needed:

npx skills add signerlabs/ShipSwift

Your AI can then browse the component catalog and read source code locally. Try:

"Explore ShipSwift recipes"
"Add a shimmer animation"
"Build a chat feature"

Tip: If you also connect the MCP server (Option 1), your AI gets access to additional Pro recipes (backend guides, compliance templates, pitfall docs).

Option 3: 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

License

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

Star History

Made with ❤️ by SignerLabs

</div>

ShipSwift

Install / Use

README

ShipSwift

What is ShipSwift?

Quick Start

Option 1: Skills + Recipe Server (Recommended)

Option 2: Local Skills (No MCP Required)

Option 3: File Copy

Run the Showcase App

Components

SWAnimation — Animation Components

SWChart — Chart Components

SWComponent — UI Components

SWModule — Multi-File Frameworks

SWUtil — Shared Utilities

Directory Structure

Naming Convention

Dependency Rules

Recipes

Free vs Pro

Tech Stack

Contributing

Code Style

License

Star History