ShipSwift

ShipSwift

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

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 · RootTabViewFeedback: Alert · Loading · ThinkingIndicatorInput: TabButton · Stepper · AddSheet

SWModule — 6 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
• 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 (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 (6 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)
│   │   └── SWTikTokTracking/ #   TikTok attribution (2 files)
│   └── 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

Recipes

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

* 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.

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.