# add-component

Adopt this skill: https://proskills.md/skills/other/signerlabs-shipswift-skills-add-component

Page: https://proskills.md/skills/other/signerlabs-shipswift-skills-add-component
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: skills/add-component/SKILL.md
size: 1726
sha: 165c2cd133497c9d17fbc0596f6077d41cf63bb3
upstream: https://github.com/signerlabs/shipswift/blob/main/skills/add-component/SKILL.md

```text
---
name: add-component
description: >
  Add a SwiftUI component from ShipSwift. Use when the user says "add component",
  "add a view", "add X view", "I need a chart", "add animation", or wants a specific UI element.
---

# Add Component from ShipSwift

Add production-ready SwiftUI components to your project from ShipSwift's local source library.

## Workflow

1. **Identify the component**: Read `skills/catalog.md` to find the right component. Common mappings:
   - "shimmer" / "loading skeleton" → `SWAnimation/SWShimmer.swift`
   - "donut chart" / "pie chart" → `SWChart/SWDonutChart.swift`
   - "alert" / "popup" → `SWComponent/Feedback/SWAlert.swift`
   - "auth" / "login" → `SWModule/SWAuth/` (all files)
   - "camera" → `SWModule/SWCamera/` (all files)

2. **Read the source file**: Read the Swift file from `ShipSwift/SWPackage/<path>`. The file contains the complete implementation.

3. **Integrate into the project**:
   - Copy the file(s) into the user's project
   - Also copy `SWUtil/` if not already present
   - Adapt naming, colors, and data models to match the project
   - For `+iOS`/`+macOS` files, set the platform filter in Xcode Build Phases

4. **Verify**: Walk through any dependencies or setup steps needed.

## Guidelines

- Types use `SW` prefix (`SWDonutChart`, `SWTypewriter`).
- View modifiers use `.sw` prefix (`.swShimmer()`, `.swGlowScan()`).
- Chart components use a generic `CategoryType` pattern with `String` convenience initializer.
- Internal helper types should be `private` with `SW` prefix.
- Components in `SWAnimation/`, `SWChart/`, and `SWComponent/` are each self-contained (single file + SWUtil).
- Modules in `SWModule/` are multi-file — copy the entire folder.
```

## File: README.md
upstream: https://github.com/signerlabs/shipswift/blob/main/README.md

````text
# ShipSwift

<div align="center">

![ShipSwift Banner](assets/banner.jpg)

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

[![Website](https://img.shields.io/badge/Website-shipswift.app-blue.svg)](https://shipswift.app)
[![App Store](https://img.shields.io/badge/App_Store-Demo_App-black.svg)](https://apps.apple.com/us/app/shipswift-mcp-codebase/id6759209764)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Swift](https://img.shields.io/badge/Swift-5.0+-F05138.svg)](https://swift.org)
[![iOS](https://img.shields.io/badge/iOS-18.0+-000000.svg)](https://developer.apple.com/ios/)
[![Skills](https://img.shields.io/badge/Skills-Powered-8A2BE2.svg)](https://github.com/signerlabs/shipswift-skills)
[![ShipSwift MCP server](https://glama.ai/mcp/servers/signerlabs/ShipSwift/badges/score.svg)](https://glama.ai/mcp/servers/signerlabs/ShipSwift)

[Quick Start](#quick-start) · [Components](#components) · [Custom Dev — $5K, 4 weeks](#need-a-custom-app-built-we-do-that-too) · [Skills](#skills)

</div>

## What is ShipSwift?

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

> **Browse every skill live at [shipswift.app/skills](https://shipswift.app/skills)** — searchable catalog, copy-paste source, live previews.

Download the [Showcase App](https://apps.apple.com/us/app/shipswift-mcp-codebase/id6759209764) to preview every component on your device.

## Need a custom app built? We do that too.

ShipSwift gets your AI 80% of the way. If you need the last 20% — your unique features, your brand, your backend — wired up by the people who wrote the skills, **we ship it for you**.

| | |
|---|---|
| ⚡ **48-hour demo** | Working prototype on your TestFlight within 2 days of brief |
| 🚀 **4-week delivery** | Production-ready iOS app, App Store-submission ready |
| 💵 **From $5,000** | Fixed price, milestone-billed, no hourly surprises |

Built on the same component library you see in this repo, so you keep ownership and can extend forever.

**Get a quote:** [wei@signerlabs.com](mailto:wei@signerlabs.com) · [shipswift.app](https://shipswift.app)

## Quick Start

### Option 1: Skills + MCP Server (Recommended)

**Step 1** — Install ShipSwift Skills:

```bash
npx skills add signerlabs/shipswift-skills
```

**Step 2** — Connect the MCP server so your AI can fetch skills:

```bash
# 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](https://github.com/signerlabs/shipswift-skills) 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:

```bash
npx skills add signerlabs/ShipSwift
```

Your AI can then browse the component catalog and read source code locally. Try:
- "Explore ShipSwift skills"
- "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 skills (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

```bash
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

**SwiftUI animations:** [Shimmer](https://shipswift.app/skills/animation-shimmer) · [TypewriterText](https://shipswift.app/skills/animation-typewriter-text) · [ShakingIcon](https://shipswift.app/skills/animation-shaking-icon) · [GlowSweep](https://shipswift.app/skills/animation-glow-sweep) · [LightSweep](https://shipswift.app/skills/animation-light-sweep) · [ScanningOverlay](https://shipswift.app/skills/animation-scanning-overlay) · [AnimatedMeshGradient](https://shipswift.app/skills/animation-animated-mesh-gradient) · [BeforeAfterSlider](https://shipswift.app/skills/animation-before-after-slider) · [OrbitingLogos](https://shipswift.app/skills/animation-orbiting-logos) · [FullScreenButton](https://shipswift.app/skills/animation-full-screen-button) · [ChangeEffect](https://shipswift.app/skills/animation-change-effect) · [Confetti](https://shipswift.app/skills/animation-confetti) · [Transition](https://shipswift.app/skills/animation-transition) · [ParticleTransition](https://shipswift.app/skills/animation-particle-transition)

**Canvas-rendered 3D:** [DotSphere](https://shipswift.app/skills/dot-sphere) · [CharSphere](https://shipswift.app/skills/animation-char-sphere)

**Metal-shader procedural backgrounds:** [Dots](https://shipswift.app/skills/dots) · [Starfield](https://shipswift.app/skills/animation-starfield) · [FractalClouds](https://shipswift.app/skills/animation-fractal-clouds) · [InkSmoke](https://shipswift.app/skills/animation-ink-smoke) · [LiquidChrome](https://shipswift.app/skills/animation-liquid-chrome) · [Plasma](https://shipswift.app/skills/animation-plasma) · [AnimatedLoop](https://shipswift.app/skills/animation-animated-loop)

**Metal-shader backgrounds:** [Metaballs](https://shipswift.app/skills/metaballs) · [Halftone](https://shipswift.app/skills/animation-halftone) · [Water](https://shipswift.app/skills/animation-water) · [LiquidMetal](https://shipswift.app/skills/animation-liquid-metal) · [NeuroNoise](https://shipswift.app/skills/neuro-noise-simplex-noise) · [DotOrbit](https://shipswift.app/skills/dot-orbit-wallet) · [Voronoi](https://shipswift.app/skills/voronoi-swirl) · [SimplexNoise](https://shipswift.app/skills/neuro-noise-simplex-noise) · [ColorPanels](https://shipswift.app/skills/color-panels) · [SmokeRing](https://shipswift.app/skills/animation-smoke-ring) · [Swirl](https://shipswift.app/skills/voronoi-swirl) · [StarNest](https://shipswift.app/skills/star-nest) · [GrainGradient](https://shipswift.app/skills/animation-grain-gradient)

**Metal-shader effects on any view:** [Foil](https://shipswift.app/skills/animation-foil) · [Glitter](https://shipswift.app/skills/glitter) · [IntenseBling](https://shipswift.app/skills/animation-intense-bling) · [PolishedAluminum](https://shipswift.app/skills/animation-polished-aluminum) · [ChromaticGlass](https://shipswift.app/skills/animation-chromatic-glass) · [Glass](https://shipswift.app/skills/animation-glass) · [GlassOrb](https://shipswift.app/skills/animation-glass-orb) · [GlassLogo](https://shipswift.app/skills/glass-logo)

44 animation components total — see the [Showcase App](https://apps.apple.com/us/app/shipswift-mcp-codebase/id6759209764) for live previews.

### SWChart — Chart Components

[LineChart](https://shipswift.app/skills/chart-line-chart) · [BarChart](https://shipswift.app/skills/chart-bar-chart) · [AreaChart](https://shipswift.app/skills/chart-area-chart) · [DonutChart](https://shipswift.app/skills/chart-donut-chart) · [RingChart](https://shipswift.app/skills/chart-ring-chart) · [RadarChart](https://shipswift.app/skills/chart-radar-chart) · [ScatterChart](https://shipswift.app/skills/chart-scatter-chart) · [ActivityHeatmap](https://shipswift.app/skills/chart-activity-heatmap) · [NetworkGraph](https://shipswift.app/skills/network-graph)

### SWComponent — UI Components

**Display:** [FloatingLabels](https://shipswift.app/skills/component-floating-labels) · [ScrollingFAQ](https://shipswift.app/skills/component-scrolling-faq) · [RotatingQuot
````
