Skip to content
A collection of iOS architectures - MVC, MVVM, MVVM+RxSwift, VIPER, RIBs and many others
Branch: master
Clone or download
Latest commit 2ca8b98 Apr 10, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Reactor add ReactorKit Mar 25, 2019
mvc Fix naming Feb 1, 2019
mvp Update MVP Feb 18, 2019
mvvm-closures bug fix Mar 22, 2019
mvvm-functions-subjects-observables Update readmes Feb 1, 2019
mvvm-rxswift-pure Update readmes Feb 1, 2019
mvvm-rxswift-subjects-observables Update readmes Feb 1, 2019
rxfeedback-mvc Add VIPER Feb 20, 2019
tmdb-mvvm-rxswift-pure Update readmes Feb 1, 2019
viper Add VIPER Feb 20, 2019
.gitignore Update gitignore Jan 26, 2019
LICENSE Create LICENSE Feb 13, 2019
README.md Update README.md Feb 20, 2019
app-ui.gif Update readme Jan 26, 2019
multiscreen-ui.gif Update readme Jan 30, 2019

README.md

ios-architecture

WIP

👷 🧱 🧰 🛠️
Demystifying MVC, MVVM, VIPER, RIBs and many others
A collection of simple one screen apps to showcase and discuss different architectural approaches in iOS

last commit open issues swift version platform license
Built with ❤︎ by Pawel Krawiec


Apps

Multi-screen examples Single screen examples
app-ui app-ui

Architectures

This repository hosts each sample app in separate directory.

⭐️ Click the title of example to see detailed README information about specific architecture.

Multiple screens app examples

🔒 ** If you want to login, use username iostest and password test.**

If you're a themoviedb user, please use your own account and API key!

Example Description
tmdb-mvvm-rxswift-pure Uses RxSwift and observables as binding mechanism between ViewController and ViewModel. Also, it uses simple navigator pattern for transitions between screens. (README in progress)

Single screen app examples

The purpose of having examples with single page applications is highlighting connection between view code and business logic code.

Example Description
mvc Standard MVC pattern recommended by Apple. Uses composition design pattern to make ViewController smaller. (README in progress)
mvp Standard MVP pattern. (README in progress)
mvvm-rxswift-pure Uses RxSwift and observables as binding mechanism between ViewController and ViewModel.
mvvm-rxswift-functions-subjects-observables Uses RxSwift and observables as outputs from ViewModel. ViewModel inputs are defined as subjects wrapped in functions.
mvvm-rxswift-subjects-observables Uses RxSwift with observables as ViewModel outputs and subjects as ViewModel inputs.
mvvm-closures Binds ViewController and ViewModel using closures and swift functions (README in progress)
rxfeedback-mvc Uses RxFeedback in MVC architecture (README in progress)
viper Uses VIPER architecture (README in progress)

Examples in progress

Example Description
reactorkit In Progress
mvvm+rxfeedback In Progress
mvvm-reactive-swift In Progress
reswift In Progress
viper-rxswift In Progress
ribs In Progress

Sample apps

Apps in this repository are split into 2 groups - single screen and multiscreen.

Simple one screen apps aim to be simple enough that you can understand crucial bits about given architecture (i.e. bindings between ViewModel and ViewController in MVVM examples). However, some other architectures require more complexity (i.e. RIBs architecture) and this is the reason of having multiscreen examples in this project.

Single screen app

Single screen app is a simple list of repositories fetched from GitHub and a text field that makes queries for new data.

Multiscreen app

Multiscreen app is a simple themoviedb client. It lets user to authenticate, view popular movies/tv shows or actors and see details about each movie. Also, it has a search screen that allows you to browse movies or actors.

Open in Xcode

Clone the repository:

git clone git@github.com:tailec/ios-architecture.git

Go to example directory, for example:

cd mvvm-pure-swift

Install pods:

pod install

Note: Some of the examples don't use external libraries so pod install is not required.

Licence

MIT.

You can’t perform that action at this time.