Quickstart
From purchase to your first piece in your Xcode project, in four steps.
Every screen installs the same way: one command with its id. Templates are complete Xcode projects with their own guide, see Templates below.
Get Swift Pieces 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 initinit 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-stackThe 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 Swift Pieces 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. 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
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.