railsbob / turbo-ios

iOS framework for making Turbo native apps

Turbo Native for iOS

Note: The Hotwire frameworks are presented in beta form. We're using them all in production with HEY, but expect that significant changes might be made in response to early feedback.

---

Build high-fidelity hybrid apps with native navigation and a single shared web view. Turbo Native for iOS provides the tooling to wrap your Turbo 7-enabled web app in a native iOS shell. It manages a single WKWebView instance across multiple view controllers, giving you native navigation UI with all the client-side performance benefits of Turbo.

Features

• Deliver fast, efficient hybrid apps. Avoid reloading JavaScript and CSS. Save memory by sharing one WKWebView.
• Reuse mobile web views across platforms. Create your views once, on the server, in HTML. Deploy them to iOS, Android, and mobile browsers simultaneously. Ship new features without waiting on App Store approval.
• Enhance web views with native UI. Navigate web views using native patterns. Augment web UI with native controls.
• Produce large apps with small teams. Achieve baseline HTML coverage for free. Upgrade to native views as needed.

Requirements

Turbo iOS is written in Swift 5.3 and requires iOS 12 or higher, but we'll most likely drop iOS 12 in the near future. It supports web apps using either Turbo 7 or Turbolinks 5. The Turbo iOS framework has no dependencies.

Note: You should understand how Turbo works with web applications in the browser before attempting to use Turbo iOS. See the Turbo 7 documentation for details. Ensure that your web app sets the window.Turbo global variable as it's required by the native apps:

import { Turbo } from "@hotwired/turbo-rails"
window.Turbo = Turbo

Getting Started

The best way to get started with Turbo iOS to try out the demo app first to get familiar with the framework. The demo app walks you through all the basic Turbo flows as well as some advanced features. To run the demo, clone this repo and open Demo/Demo.xcworkspace in Xcode and run the Demo target. See Demo/README.md for more details about the demo. When you’re ready to start your own application, read through the rest of the documentation.

Documentation

• Installation
• Quick Start
• Overview
• Authentication
• Path Configuration
• Migration
• Advanced

Contributing

Turbo iOS is open-source software, freely distributable under the terms of an MIT-style license. The source code is hosted on GitHub. Development is sponsored by Basecamp.

We welcome contributions in the form of bug reports, pull requests, or thoughtful discussions in the GitHub issue tracker.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

---

© 2020 Basecamp, LLC