shipswift

ShipSwift is an open-source SwiftUI component library designed to be consumed by AI coding assistants. It bundles production-ready UI code together with "recipes" — implementation steps and guidance — so that large language models can generate real iOS app features instead of guessing at APIs. What it contains: - SWAnimation: roughly 30 animation components, including SwiftUI effects (shimmer, typewriter text, shaking icon, glow/light sweeps, scanning overlay, animated mesh gradient, before/after slider, orbiting logos), Canvas-rendered 3D pieces (dot sphere, character sphere), and Metal-shader procedural backgrounds (starfield, fractal clouds, ink smoke, liquid chrome, plasma, metaballs, halftone, water, voronoi, simplex noise and others). - SWChart: line, bar, area, donut, ring, radar, scatter charts and an activity heatmap. - SWComponent: display, feedback and input building blocks such as floating labels, scrolling FAQ, rotating quote, markdown text, onboarding view, order view, root tab view, video player, alerts, loading states, thinking indicator, tab buttons, steppers, add sheets and search bars. - SWModule: multi-file frameworks covering authentication (Amplify/Cognito, social and phone sign-in), camera capture with Vision face detection, a StoreKit 2 subscription paywall, a chat view with optional voice recognition, a settings page template, background removal via VisionKit, and TikTok Events API attribution tracking. - SWUtil: shared helpers such as debug logging, string/date/view extensions and a location manager. How it is used: Three integration paths are documented. The recommended one installs "skills" via npx and connects an MCP server endpoint so the assistant can fetch recipes on demand; a local variant reads source files directly from the repository without a server; and a manual path simply copies files from SWPackage into an Xcode project. Each component is described as self-contained, with a stated dependency rule that SWUtil has no internal dependencies, SWAnimation/SWChart/SWComponent may depend only on SWUtil, and SWModule may depend on SWUtil and SWComponent. Types use an SW prefix and view modifiers use a lowercase .sw prefix. Licensing and scope: All iOS client code is MIT-licensed. Some recipes are labeled Pro and add backend implementation details, integration checklists, compliance templates and pitfall notes; the README also mentions a paid custom app development service. A companion showcase app is available on the App Store for previewing components on a device. The project targets Swift 5.0+ and iOS 18.0+, and lists SwiftUI, StoreKit 2, Amplify SDK, AVFoundation/Vision, SpriteKit and VolcEngine ASR among its technologies. Contributions are accepted via fork and pull request, with English comments and adherence to the naming and dependency conventions requested.