iosSwiftProjectTemplate

My personal iOS bootstrapped project template. Lots of time/efforts invested to create a truly get-go iOS app project template.

Battery-included

• Targeting Swift 5 and iOS 12
• Scaffolded by liftoff
• Brewfile to install toolings
• Opinionated Podfile
• Swiftlint and its Build phase script
• Ackack and its Build phase script
• R.swift and its Build phase script
• Target schemas setup from local dev to production
• Environment read from xcconfig file
• Few base classes
• No Main Storyboard to prefer programmatical UI

Setup

First, run bin/setup

This will:

• Install the brew dependencies
• Initiate pod install

Second, you need to rename this Xcode. Follow this link

Third, you need to rename R.swift paths after you renamed this Xcode project:

1. Go to .xcodeproj -> Build Phases -> R.swift run section. Change iosSwiftProjectTemplate to your new project name.
2. Change .swiftlint file to exclude R.generated.swift file correctly under your new project name.
3. Build your project to generate R.swift artifact file
4. Delete missing R.generated.swift and add the reference back to Resources/Other-Sources inside your project

Fourth, replace iosSwiftProjectTemplate (and COMPANY_NAME) in the followings:

• Organization name in project target
• Launch screen storyboard
• bin/test script
• AppDelegate.swift
• BaseViewController.swift
• Environment.swift

Fifth, add the followings to Configs in your project folder based on .xcconfig_example:

• Development.xcconfig
• Staging.xcconfig
• QA.xcconfig
• Production.xcconfig
• Change .xcconfig_example to replace iosSwiftProjectTemplate

Sixth, you need to re-configure project configurations with your above xcconfig files.

As a last sweep, search any iosSwiftProjectTemplate or COMPANY_NAME string in the project and replace them properly.

Now, run build and now your Xcode project is now ready to be developed!

Xcconfig file

This project is already configured to use inherited xcconfigs from this project configuration Pods.

There is a sample xcconfig file inside Configs folder.

Testing

Run bin/test

This will run the tests from the command line, and pipe the result through XCPretty.