Turbo Native workshop guide
Welcome to the Turbo Native workshop. I can’t wait to get started!
Today you will learn how to use the Turbo Native iOS wrapper to build high-fidelity hybrid apps with native navigation.
This guide includes:
The workshop is split into multiple phases each covering a different Turbo Native topic.
Each phase will start with some live coding to build out a feature. I will walk through each step and call out common pitfalls, gotchas, and tips that I’ve seen from past projects. Please raise your hand (in Zoom) if you have any questions.
Then you will work through an activity on your own. This will give you a chance to do some coding and ensure the concepts stick.
We will wrap up each phase with an example solution to the activity and a Q&A session on the topic.
Note: To check out a tag run
git checkout TAG_NAMEfrom the repository.
Phase 0: Project overview
Before we dive in let’s take a look at what we are building. Make sure you have
main checked out on both the iOS and Rails repo. Play around with the web app and native app to get a feel for what’s to come.
Phase 1: Turbo Native integration and overview
Let’s dive in! In this phase we will cover some high-level iOS concepts, integrating Turbo Native, pushing/popping/presenting controllers, the Path Configuration, and handling errors.
phase-1 on both repos to begin.
Phase 1: Activity
Spend 5 minutes poking around and jot down things that feel “off” or weird in the app.
The code we have so far is most of what you get from the Demo app in the Hotwire repo. Let’s see how many issues we can fix today.
Phase 2: Native look and feel
The app is working great but some things feel a little off. That navigation bar at the top isn’t very iOS friendly. And what’s with every page saying “Board Game Shelf” at the top? Let’s make the app feel a bit more native.
phase-2 on both repos to begin.
Phase 2: Activity
We successfully replaced a screen when signing in and out. But what about when updating a game? Let’s apply the same logic – be careful not to break the flow when adding a new game, though!
phase-2-activity on the Rails repo (only) to begin.
Phase 3: Web-based authentication
This phase introduces a way for the iOS app to authenticate with the Rails app with (relatively) little native code. It leverages the existing Devise authentication and web-based sign in screens.
phase-3 on both repos to begin.
Phase 3: Activity
Authentication is looking good! But there’s a bug that can cause some confusion for users.
Follow these steps to reproduce it:
- Sign out and rerun the app
- Tap a game
- Tap edit
- Sign in
- Dismiss the edit screen
- Tap the back button
When you open the navbar we are no longer signed in!
phase-3-activity on the iOS repo (only) to begin.
So far we only have two ways to communicate between the Rails and iOS apps: HTTP status codes and URL routing. What if we want to get a little more granular?
phase-4 on both repos to begin.
Phase 4: Activity
Now that we have a feel for native buttons let’s add another! Add a
+ button on the right side of the Home Screen. When clicked, push the “Add a game” page.
phase-4-activity on both repos to begin.
Refactoring, we can make our button more dynamic. So dynamic that the iOS app only needs to know two things: what symbol to show and what DOM element to click.
Undo your changes to reset back to
phase-4-activity on both repos to begin.
Phase 5: Native screens
What would a Turbo Native app be without a native screen or two?
Let’s add a profile page for signed in users. First, we will add the HTML-based version then progressively enhance it with a SwiftUI-powered one.
We will authenticate the native HTTP request with cookies shared from the web view.
phase-5 on both repos to begin.
Phase 5: Activity
Now that we have a feel for native screens, let’s add another one!
Add a native screen, powered by a JSON endpoint, to view an individual board game.
phase-5-activity on both repos to begin.
Note that only workshop attendees have access to these codebases.
Thank you again for attending this workshop. I hope you learned enough to get started on your own Turbo Native app!
If you have any questions we didn’t cover please email me at firstname.lastname@example.org and I’ll do my best to help.
Please get in touch if you’d like to work together. I have a variety of Turbo Native-related offerings, including:
- Private, customized workshops for you team - Best if you want to level up your team and build your own app.
- Consulting work – Best if you need an app ASAP and want me to build it.
- Advisory engagements – Best if you need support and advice while building an app.
I’m looking forward to hearing from you! 👋