Skip to content

signerlabs/ShipSwift

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

201 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ShipSwift

ShipSwift Banner

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

Website App Store License: MIT Swift iOS Skills

Quick Start · Components · Directory Structure · Recipes · Contributing


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

  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 — 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:

  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.


Star History

Star History Chart

Made with ❤️ by SignerLabs

About

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

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages