Pilot: Cross-platform MVVM in Swift
If you squint, any modern client application can viewed as a "scrollable list of stuff from the internet". Whether it's a scrollable list of food, photos, videos, merchandise, cats, or cat merchandise -- all applications share common scaffolding.
Pilot provides a suite of robust components to take care of this common scaffolding so you can focus on what matters: your data (
Model), business logic (
ViewModel), and presentation (
These components are not overly-prescriptive to any particular application architecture, so you can adopt them without having to rewrite or commit to Pilot forever.
Pilot is modularized into components providing building blocks for fast and safe application development (see flight plan for upcoming components).
- Pilot: Provides a core MVVM stack, various model collections, diff engine, action handling, along with some minimal async, observable, and logging components. This is a Foundation-only framework (i.e. No UIKit or AppKit)
- PilotUI: UI layer components built atop
Pilotfor both Mac and iOS. Contains collection view bindings and other macOS/iOS extensions for Pilot development.
See the Getting Started guide for a basic walkthrough of core concepts.
There is a Sample Project which demonstrates macOS app and iOS app built from the same Pilot MVVM stack.
Otherwise, please see type documentation and let us know if anything is unclear.
- Xcode 9.2
- Swift 4.0
- iOS 9.0+ / macOS 10.11+
Pilot.xcodeprojinto Project Navigator
- Go to
Project > Targets > General > Embed Frameworks, click
+, and select
Project > Targets > Build Phases > Target Dependencies, ensure
PilotUI [Platform]are there.
The GYP config is an alternative way of using Pilot, it's ONLY for using it in other GYP projects. If you don't know what GYP is, you can safely ignore this section here.
- Generate iOS Xcode project via
gyp Pilot.gyp --depth=. --suffix=.ios.dxbuild -DOS=ios
- Generate MacOS Xcode project via
gyp Pilot.gyp --depth=. --suffix=.osx.dxbuild -DOS=mac
- Use generated
Pilot.ios.dxbuild.xcodeprojto build Pilot for iOS, or