/motion-turbolinks

Work in progress...Turbolinks for RubyMotion apps

Primary LanguageRubyMIT LicenseMIT

Turbolinks for RubyMotion

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

Features

Features of Turbolinks

  • 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.

Features of Turbolinks for RubyMotion

  • Ruby syntax. Native performance. Build native iOS and Android apps using the Ruby syntax you know and love with the same performance as Swift and Java by using RubyMotion.
  • One codebase. Multiple platforms. Use Turbolinks for RubyMotion with the Flow framework to create a single codebase that targets both iOS and Android so that you only have one codebase to maintain.

Requirements

Turbolinks for RubyMotion is compatible with all versions of RubyMotion.

Note: We recommend that you spend some time to understand how Turbolinks works with web applications in the browser before attempting to use Turbolinks for RubyMotion. See the Turbolinks 5 documentation for details.

iOS Requirements

For iOS apps, it requires iOS 8 or higher.

Web views are backed by WKWebView for full-speed JavaScript performance.

Android Requirements

For Android apps, motion-gradle is required.

Installation

Add this line to your application's Gemfile:

gem 'motion-turbolinks', github: 'andrewhavens/motion-turbolinks'

And then execute:

$ bundle

For Android apps, install the Gradle dependencies:

$ bundle exec rake gradle:install

Getting Started

When you’re ready to start your own application, see our Quick Start Guide for step-by-step instructions to lay the foundation.

Contributing to Turbolinks for RubyMotion

Turbolinks is open-source software, freely distributable under the terms of an MIT-style license. Turbolinks for RubyMotion is based on Turbolinks for iOS. Development of Turbolinks for iOS/Android is sponsored by Basecamp. Turbolinks for RubyMotion was created by Andrew Havens.

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