# signerlabs/shipswift architecture

> Architecture diagram of the GitHub repository signerlabs/shipswift, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/signerlabs/shipswift
- Repository: https://github.com/signerlabs/shipswift

## Overview

ShipSwift is an AI-oriented SwiftUI component and recipe library, accompanied here by a showcase app for browsing its components and modules. The showcase starts at the app root and routes users through tabs to animation, chart, UI, and module demos; the package supplies reusable components, while auth and purchase managers provide the showcase’s account and Pro flows. README documents additional framework capabilities whose implementation details are not all sampled. Edges to those capabilities are documented rather than inferred from unsampled code.

Main entry points: [`ShipSwift/ShipSwiftApp.swift`](https://github.com/signerlabs/shipswift/blob/main/ShipSwift/ShipSwiftApp.swift) (App Bootstrap), [`ShipSwift/View/RootTabView.swift`](https://github.com/signerlabs/shipswift/blob/main/ShipSwift/View/RootTabView.swift) (Tab Navigation), [`ShipSwift/SWPackage/SWModule/SWPaywall/SWStoreManager.swift`](https://github.com/signerlabs/shipswift/blob/main/ShipSwift/SWPackage/SWModule/SWPaywall/SWStoreManager.swift) (Subscription Manager), [`ShipSwift/SWPackage/SWModule/SWAuth/SWUserManager.swift`](https://github.com/signerlabs/shipswift/blob/main/ShipSwift/SWPackage/SWModule/SWAuth/SWUserManager.swift) (User Manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_showcase["Showcase App"]
  node_app["App Bootstrap<br/>[ShipSwiftApp.swift]"]
  node_tabs["Tab Navigation<br/>[RootTabView.swift]"]
  node_home["Home Showcase<br/>[HomeView.swift]"]
  node_animation_demo["Animation Gallery"]
  node_chart_demo["Chart Gallery"]
  node_ui_demo["UI Gallery<br/>[UIListView.swift]"]
  node_module_demo["Module Gallery"]
  node_auth_demo["Showcase Sign-in"]
  node_paywall_demo["Pro Paywall"]
  node_list_item["Gallery List Item<br/>[ListItem.swift]"]
end

subgraph group_visuals["SwiftUI Components"]
  node_animations["Animation Library"]
  node_charts["Chart Library"]
  node_ui_components["UI Components"]
end

subgraph group_modules["Framework Modules"]
  node_auth_views["Auth Framework"]
  node_auth_manager["User Manager"]
  node_auth_agreements["Agreement Checks"]
  node_auth_countries["Country Data"]
  node_camera["Camera Framework"]
  node_chat["Chat Framework"]
  node_paywall["Subscription Manager"]
  node_settings["Settings Framework"]
  node_subject_lifting["Background Removal"]
  node_tracking["TikTok Tracking"]
end

subgraph group_services["App Services"]
  node_api_client["ShipSwift API Client"]
end

node_user(("App User"))
node_storekit(("App Store"))
node_amplify(("Amplify Cognito"))
node_ship_api(("ShipSwift Server"))
node_vision(("Apple Vision"))
node_tiktok_sdk(("TikTok SDK"))

node_user -->|"opens"| node_app
node_app -->|"presents"| node_tabs
node_tabs -->|"routes"| node_home
node_tabs -->|"routes"| node_animation_demo
node_tabs -->|"routes"| node_chart_demo
node_tabs -->|"routes"| node_ui_demo
node_tabs -->|"routes"| node_module_demo
node_animation_demo -->|"renders"| node_list_item
node_chart_demo -->|"renders"| node_list_item
node_ui_demo -->|"renders"| node_list_item
node_animation_demo -->|"previews"| node_animations
node_chart_demo -->|"previews"| node_charts
node_ui_demo -->|"previews"| node_ui_components
node_app -->|"creates"| node_auth_manager
node_app -->|"configures"| node_paywall
node_app -->|"configures"| node_tracking
node_app -.->|"configures"| node_amplify
node_app -->|"initializes"| node_tiktok_sdk
node_auth_demo -->|"authenticates"| node_auth_manager
node_auth_demo -->|"checks consent"| node_auth_agreements
node_auth_views -->|"uses"| node_auth_manager
node_auth_views -->|"checks consent"| node_auth_agreements
node_auth_views -->|"uses picker data"| node_auth_countries
node_auth_manager -.->|"authenticates via"| node_amplify
node_paywall_demo -->|"purchases through"| node_paywall
node_paywall -.->|"checks purchases"| node_storekit
node_paywall -->|"syncs purchase"| node_api_client
node_api_client -->|"requests API"| node_ship_api
node_camera -.->|"detects faces"| node_vision
node_subject_lifting -.->|"removes backgrounds"| node_vision
node_chat -.->|"optional voice service"| node_tiktok_sdk
node_tracking -.->|"tracks attribution"| node_tiktok_sdk

click node_app "https://github.com/signerlabs/shipswift/blob/main/ShipSwift/ShipSwiftApp.swift"
click node_tabs "https://github.com/signerlabs/shipswift/blob/main/ShipSwift/View/RootTabView.swift"
click node_home "https://github.com/signerlabs/shipswift/blob/main/ShipSwift/View/HomeView.swift"
click node_animation_demo "https://github.com/signerlabs/shipswift/blob/main/ShipSwift/View/AnimationListView.swift"
click node_chart_demo "https://github.com/signerlabs/shipswift/blob/main/ShipSwift/View/ChartListView.swift"
click node_ui_demo "https://github.com/signerlabs/shipswift/blob/main/ShipSwift/View/UIListView.swift"
click node_module_demo "https://github.com/signerlabs/shipswift/blob/main/ShipSwift/View/ModuleListView.swift"
click node_auth_demo "https://github.com/signerlabs/shipswift/blob/main/ShipSwift/View/ShipSwiftAuthView.swift"
click node_paywall_demo "https://github.com/signerlabs/shipswift/blob/main/ShipSwift/View/ProPaywallView.swift"
click node_list_item "https://github.com/signerlabs/shipswift/blob/main/ShipSwift/Component/ListItem.swift"
click node_animations "https://github.com/signerlabs/shipswift/tree/main/ShipSwift/SWPackage/SWAnimation"
click node_charts "https://github.com/signerlabs/shipswift/tree/main/ShipSwift/SWPackage/SWChart"
click node_ui_components "https://github.com/signerlabs/shipswift/tree/main/ShipSwift/SWPackage/SWComponent"
click node_auth_views "https://github.com/signerlabs/shipswift/blob/main/ShipSwift/SWPackage/SWModule/SWAuth/SWAuthView%2BiOS.swift"
click node_auth_manager "https://github.com/signerlabs/shipswift/blob/main/ShipSwift/SWPackage/SWModule/SWAuth/SWUserManager.swift"
click node_auth_agreements "https://github.com/signerlabs/shipswift/blob/main/ShipSwift/SWPackage/SWModule/SWAuth/SWAgreementChecker.swift"
click node_auth_countries "https://github.com/signerlabs/shipswift/blob/main/ShipSwift/SWPackage/SWModule/SWAuth/SWCountryData.swift"
click node_camera "https://github.com/signerlabs/shipswift/tree/main/ShipSwift/SWPackage/SWModule/SWCamera"
click node_chat "https://github.com/signerlabs/shipswift/tree/main/ShipSwift/SWPackage/SWModule/SWChat"
click node_paywall "https://github.com/signerlabs/shipswift/blob/main/ShipSwift/SWPackage/SWModule/SWPaywall/SWStoreManager.swift"
click node_settings "https://github.com/signerlabs/shipswift/tree/main/ShipSwift/SWPackage/SWModule/SWSetting"
click node_subject_lifting "https://github.com/signerlabs/shipswift/tree/main/ShipSwift/SWPackage/SWModule/SWSubjectLifting"
click node_tracking "https://github.com/signerlabs/shipswift/tree/main/ShipSwift/SWPackage/SWModule/SWTikTokTracking"
click node_api_client "https://github.com/signerlabs/shipswift/blob/main/ShipSwift/Service/ShipSwiftAPIService.swift"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_tabs,node_home,node_animation_demo,node_chart_demo,node_ui_demo,node_module_demo,node_auth_demo,node_paywall_demo,node_list_item,node_user toneBlue
class node_animations,node_charts,node_ui_components toneAmber
class node_auth_views,node_auth_manager,node_auth_agreements,node_auth_countries,node_camera,node_chat,node_paywall,node_settings,node_subject_lifting,node_tracking,node_ship_api toneMint
class node_api_client toneRose
class node_storekit,node_amplify,node_vision,node_tiktok_sdk toneIndigo
```

## Components

### Showcase App

- [App Bootstrap](https://github.com/signerlabs/shipswift/blob/main/ShipSwift/ShipSwiftApp.swift): `ShipSwift/ShipSwiftApp.swift`
- [Tab Navigation](https://github.com/signerlabs/shipswift/blob/main/ShipSwift/View/RootTabView.swift): `ShipSwift/View/RootTabView.swift`
- [Home Showcase](https://github.com/signerlabs/shipswift/blob/main/ShipSwift/View/HomeView.swift): `ShipSwift/View/HomeView.swift`
- [Animation Gallery](https://github.com/signerlabs/shipswift/blob/main/ShipSwift/View/AnimationListView.swift): `ShipSwift/View/AnimationListView.swift`
- [Chart Gallery](https://github.com/signerlabs/shipswift/blob/main/ShipSwift/View/ChartListView.swift): `ShipSwift/View/ChartListView.swift`
- [UI Gallery](https://github.com/signerlabs/shipswift/blob/main/ShipSwift/View/UIListView.swift): `ShipSwift/View/UIListView.swift`
- [Module Gallery](https://github.com/signerlabs/shipswift/blob/main/ShipSwift/View/ModuleListView.swift): `ShipSwift/View/ModuleListView.swift`
- [Showcase Sign-in](https://github.com/signerlabs/shipswift/blob/main/ShipSwift/View/ShipSwiftAuthView.swift): `ShipSwift/View/ShipSwiftAuthView.swift`
- [Pro Paywall](https://github.com/signerlabs/shipswift/blob/main/ShipSwift/View/ProPaywallView.swift): `ShipSwift/View/ProPaywallView.swift`
- [Gallery List Item](https://github.com/signerlabs/shipswift/blob/main/ShipSwift/Component/ListItem.swift): `ShipSwift/Component/ListItem.swift`

### SwiftUI Components

- [Animation Library](https://github.com/signerlabs/shipswift/tree/main/ShipSwift/SWPackage/SWAnimation): `ShipSwift/SWPackage/SWAnimation`
- [Chart Library](https://github.com/signerlabs/shipswift/tree/main/ShipSwift/SWPackage/SWChart): `ShipSwift/SWPackage/SWChart`
- [UI Components](https://github.com/signerlabs/shipswift/tree/main/ShipSwift/SWPackage/SWComponent): `ShipSwift/SWPackage/SWComponent`

### Framework Modules

- [Auth Framework](https://github.com/signerlabs/shipswift/blob/main/ShipSwift/SWPackage/SWModule/SWAuth/SWAuthView%2BiOS.swift): `ShipSwift/SWPackage/SWModule/SWAuth/SWAuthView+iOS.swift`
- [User Manager](https://github.com/signerlabs/shipswift/blob/main/ShipSwift/SWPackage/SWModule/SWAuth/SWUserManager.swift): `ShipSwift/SWPackage/SWModule/SWAuth/SWUserManager.swift`
- [Agreement Checks](https://github.com/signerlabs/shipswift/blob/main/ShipSwift/SWPackage/SWModule/SWAuth/SWAgreementChecker.swift): `ShipSwift/SWPackage/SWModule/SWAuth/SWAgreementChecker.swift`
- [Country Data](https://github.com/signerlabs/shipswift/blob/main/ShipSwift/SWPackage/SWModule/SWAuth/SWCountryData.swift): `ShipSwift/SWPackage/SWModule/SWAuth/SWCountryData.swift`
- [Camera Framework](https://github.com/signerlabs/shipswift/tree/main/ShipSwift/SWPackage/SWModule/SWCamera): `ShipSwift/SWPackage/SWModule/SWCamera`
- [Chat Framework](https://github.com/signerlabs/shipswift/tree/main/ShipSwift/SWPackage/SWModule/SWChat): `ShipSwift/SWPackage/SWModule/SWChat`
- [Subscription Manager](https://github.com/signerlabs/shipswift/blob/main/ShipSwift/SWPackage/SWModule/SWPaywall/SWStoreManager.swift): `ShipSwift/SWPackage/SWModule/SWPaywall/SWStoreManager.swift`
- [Settings Framework](https://github.com/signerlabs/shipswift/tree/main/ShipSwift/SWPackage/SWModule/SWSetting): `ShipSwift/SWPackage/SWModule/SWSetting`
- [Background Removal](https://github.com/signerlabs/shipswift/tree/main/ShipSwift/SWPackage/SWModule/SWSubjectLifting): `ShipSwift/SWPackage/SWModule/SWSubjectLifting`
- [TikTok Tracking](https://github.com/signerlabs/shipswift/tree/main/ShipSwift/SWPackage/SWModule/SWTikTokTracking): `ShipSwift/SWPackage/SWModule/SWTikTokTracking`

### App Services

- [ShipSwift API Client](https://github.com/signerlabs/shipswift/blob/main/ShipSwift/Service/ShipSwiftAPIService.swift): `ShipSwift/Service/ShipSwiftAPIService.swift`

### Other components

- **App User**
- **App Store**
- **Amplify Cognito**
- **ShipSwift Server**
- **Apple Vision**
- **TikTok SDK**

## Connections

- App User → App Bootstrap: opens (evidence: `ShipSwift/ShipSwiftApp.swift`)
- App Bootstrap → Tab Navigation: presents (evidence: `ShipSwift/ShipSwiftApp.swift`)
- Tab Navigation → Home Showcase: routes (evidence: `ShipSwift/View/RootTabView.swift`)
- Tab Navigation → Animation Gallery: routes (evidence: `ShipSwift/View/RootTabView.swift`)
- Tab Navigation → Chart Gallery: routes (evidence: `ShipSwift/View/RootTabView.swift`)
- Tab Navigation → UI Gallery: routes (evidence: `ShipSwift/View/RootTabView.swift`)
- Tab Navigation → Module Gallery: routes (evidence: `ShipSwift/View/RootTabView.swift`)
- Animation Gallery → Gallery List Item: renders (evidence: `ShipSwift/View/AnimationListView.swift`)
- Chart Gallery → Gallery List Item: renders (evidence: `ShipSwift/View/ChartListView.swift`)
- UI Gallery → Gallery List Item: renders (evidence: `ShipSwift/View/UIListView.swift`)
- Animation Gallery → Animation Library: previews (evidence: `ShipSwift/View/AnimationListView.swift`)
- Chart Gallery → Chart Library: previews (evidence: `ShipSwift/View/ChartListView.swift`)
- UI Gallery → UI Components: previews (evidence: `ShipSwift/View/UIListView.swift`)
- App Bootstrap → User Manager: creates (evidence: `ShipSwift/ShipSwiftApp.swift`)
- App Bootstrap → Subscription Manager: configures (evidence: `ShipSwift/ShipSwiftApp.swift`)
- App Bootstrap → TikTok Tracking: configures (evidence: `ShipSwift/ShipSwiftApp.swift`)
- App Bootstrap → Amplify Cognito: configures (evidence: `ShipSwift/ShipSwiftApp.swift`)
- App Bootstrap → TikTok SDK: initializes (evidence: `ShipSwift/ShipSwiftApp.swift`)
- Showcase Sign-in → User Manager: authenticates (evidence: `ShipSwift/View/ShipSwiftAuthView.swift`)
- Showcase Sign-in → Agreement Checks: checks consent (evidence: `ShipSwift/View/ShipSwiftAuthView.swift`)
- Auth Framework → User Manager: uses (evidence: `ShipSwift/SWPackage/SWModule/SWAuth/SWAuthView+iOS.swift`)
- Auth Framework → Agreement Checks: checks consent (evidence: `ShipSwift/SWPackage/SWModule/SWAuth/SWAuthView+iOS.swift`)
- Auth Framework → Country Data: uses picker data (evidence: `ShipSwift/SWPackage/SWModule/SWAuth/SWAuthView+iOS.swift`)
- User Manager → Amplify Cognito: authenticates via (evidence: `ShipSwift/SWPackage/SWModule/SWAuth/SWUserManager.swift`)
- Pro Paywall → Subscription Manager: purchases through (evidence: `ShipSwift/View/ProPaywallView.swift`)
- Subscription Manager → App Store: checks purchases (evidence: `README.md`)
- Subscription Manager → ShipSwift API Client: syncs purchase (evidence: `ShipSwift/SWPackage/SWModule/SWPaywall/SWStoreManager.swift`)
- ShipSwift API Client → ShipSwift Server: requests API (evidence: `ShipSwift/Service/ShipSwiftAPIService.swift`)
- Camera Framework → Apple Vision: detects faces (evidence: `README.md`)
- Background Removal → Apple Vision: removes backgrounds (evidence: `README.md`)
- Chat Framework → TikTok SDK: optional voice service (evidence: `README.md`)
- TikTok Tracking → TikTok SDK: tracks attribution (evidence: `README.md`)
