Documentation

Installation

Swift Starter Kits is currently distributed through email as a direct download. After purchasing a license, you’ll receive a download link in your email (if you didn’t, email me).

Xcode Environment Setup

As a pre-requisite to building with Swift Starter Kits, you’ll need to have Xcode, the Xcode Developer Tools, and an Apple Developer ID.

Create an Apple ID

If you don’t already have one, you’ll need an Apple Developer account and a valid Apple ID. This is required to download Apple’s developer tools, build on a physical device, and publish apps to the App Store. A Developer account can be created on the Apple Developer Portal.

Download Xcode

Download and install Xcode. As of this writing, Swift Starter Kits requires Xcode 15.4 or above. There are several options for downloading Xcode:

  • Official Download: Apple’s Developer Site
  • Faster download alternative: Download the dmg directly from this StackOverflow post.
  • Faster download alternative (recommended): Use the Xcodes open source application for Xcode downloads + version management.

Repository Setup

Project Download

Download the project from the download URL that was provided with your purchase, unzipping it if necessary.

Next, move the downloaded directory (which is named SwiftStarterKits{version}, depending on the version at time of purchase) wherever you’d like in your file system, likely wherever you typically write code. For the next few snippets we will assume you’ve chosen to place the directory at ~/dev/.

You can either drag and drop the folder into ~/dev/ manually using Finder, or by with your terminal emulator of choice:

cd ~/Downloads
mv SwiftStarterKits-2.1.0 ~/dev

Your downloaded kit should now have a happy home in your file system.

Repository Maintainance

It’s expected (and encouraged!) that Swift Starter Kits be used as a starting place for building your app. Every single source file and asset resource should be changed as needed. However, this poses a problem for using the kit as a new project base more than once.

Because of this, it’s recommended that you maintain a clean, untouched copy of the Swift Starter Kits project somewhere in your filesystem. You can choose to keep multiple versions of the kit as they become available (this is straightforward, given each version download is semantically versioned), or replace your existing SwiftStarterKits directory with updated versions as they are released.

For instructions on creating new projects using Swift Starter Kits, visit the Creating a New Project guide.