Docs

Quickstart

SwiftPieces Pro is delivered as SwiftUI source. Install a screen with the CLI or MCP, or download a template as an Xcode project.

SwiftPieces Pro is delivered as SwiftUI source in your project. Install a screen with the CLI or a coding agent over MCP, or download a template as an Xcode project. Updates stay on your account for the life of the license. There is no subscription.

Every screen and block installs the same way: one command with its id. Templates are complete Xcode projects with their own guide, see Templates below.

Get SwiftPieces Pro

Buy it once on the Pro page. Access is tied to your account and never expires.

Create a license key

Open your account page and choose New key. Copy it right away; keys are shown once. The same key works for the CLI and for coding agents.

Connect your project

Run these from the folder that contains your .xcodeproj:

npx swiftpieces login sp_live_your_key
npx swiftpieces init

init creates a SwiftPieces folder next to your app sources. In Xcode, drag that folder into your app target once. Xcode keeps it in sync, so everything you add later appears automatically.

Add a piece

Every page in the library shows its id under the title. Add it with:

npx swiftpieces add wallet-stack

The files land in SwiftPieces/, together with anything the piece depends on. Build and run: each piece ends with the example screen from its preview, ready to adapt.

Using a coding agent instead

Connect Claude Code, Cursor or another MCP client with the same license key, then ask for pieces in plain English, such as "add the Wallet screen from SwiftPieces Pro". Setup takes one command: see MCP and agents.

Templates

Templates ship as complete Xcode projects with onboarding, purchases, sign-in, storage and widgets already wired. Each one ships its app as flows, from first run through the paywall to profile and settings, and its guide lists every screen and flow. Download one from its guide and rename it with one command:

  • Cadence, a subscription habit tracker
  • Ledgerly, personal finance
  • Nimbus, an AI assistant
  • Margin, a workday planner
  • Stillwater, meditation, breathing and a journal
  • Wayfare, trips, stays and bookings
  • Drift, sleep and recovery for a smart ring
  • Maison, a smart home
  • Sprig, meal planning and groceries
  • Almanac, weather set like a printed page
  • Pulse, training with rhythm: a weekly plan, full-screen interval sessions and progress
  • Parla, a language course you play: a lesson path, word-tile exercises and passport stamps

Games

SwiftPieces Games installs the same way as a template: each game is a complete Xcode project with its own guide. Download it, run scripts/setup.sh with your name and bundle id, and build. Each game's guide is under Games in the sidebar, or open it from the games library.

Next

  • Theming: give every installed piece your brand in one place.
  • CLI reference: every command and option.

Requirements

  • Xcode 16 or later, an iOS 17 deployment target, and Node.js 18 or later for npx.
  • Pieces with Liquid Glass need the iOS 26 SDK to compile. Earlier iOS versions get a material fallback automatically.