Skip to content

A custom Xcode project template to get started with Turbo Native development.

License

Notifications You must be signed in to change notification settings

joemasilotti/TurboNativeXcodeTemplate

Repository files navigation

Turbo Native app template for Xcode

A custom Xcode project template to get started with Turbo Native development.

Turbo Native App template in Xcode

Once installed, this template can be used directly in Xcode to generate a new Turbo Native project. It removes boilerplate around creating new Xcode projects and integrating with Turbo Native.

Note: This project is an experiment with frequent, breaking changes as I learn how Xcode templates work.

Getting started

First, make sure you have Xcode downloaded and installed from the App Store.

Install the template

Create a new directory for custom Xcode project templates. Then clone this repo into that directory.

export DIR=~/Library/Developer/Xcode/Templates/Custom\ Templates
mkdir -p $DIR
git clone https://github.com/joemasilotti/TurboNativeXcodeTemplate.git $DIR/Turbo\ Native\ App.xctemplate

Create a new project

Open Xcode and create a new project via File → New → Project…

Select iOS from the tabs across the top and scroll to the bottom.

Select Turbo Native App, click Next, enter the name of your app, and click Next again.

You might also need to add an organization identifier if you aren't signed in to an App Store Connect team in Xcode.

Add the Turbo Native package dependency

Unfortunately, Xcode project templates don't directly support Swift packages. So we have to add it manually.

Add the turbo-ios Swift package to an Xcode project

  1. Click File → Add Packages…
  2. In the search box in the upper right, enter: https://github.com/hotwired/turbo-ios
  3. Click Add Package
  4. Click Add Package, again

Run the app via Product → Run. If all went well it should launch in the simulator!

For the best experience, start a Rails server with Turbo.js enabled on port 3000.

About

A custom Xcode project template to get started with Turbo Native development.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages