Xcode Template

My favorite Xcode project structure, plus SwiftLint and SwiftFormat pre-configured.

Getting started

1. Install Xcode

   • App Store (easiest)
   • Developer Portal
   • Xcodes (recommended)

2. Verify your Ruby version

   ruby --version

   Ideally it show you something like this (Required: >= 3.3.0):

   ruby 3.3.0 (2023-12-25 revision 5124f9ac75) [arm64-darwin23]

   Check the Troubleshooting Guide to fix your Ruby version.

3. Install bundler

   gem install bundler --user-install

4. Clone this repository via SSH

   git clone git@github.com:hoppsen/xcode-template.git

   Check the Troubleshooting Guide to setup SSH (for GitHub).

5. Navigate to the project's directory.

6. Install all gems via bundle.

   bundle install

7. Rename the whole project to a name of your choice.

   bundle exec fastlane rename new_name:Hoppsen

8. Validate all name changes within Git

9. Run our guided setup script.

   bundle exec fastlane setup

10. Open Template.xcodeproj

11. Start coding 🚀

---

Project created with template from https://github.com/hoppsen/xcode-template.