Awesome Open Source
Awesome Open Source


cocoapods language LICENSE version


🚀 A seamless framework for build app from MVC, MVVM, VIPER (etc.) design pattern in iOS world. (OC & Swift)

  • Assemble a VIPER module as fast so far, only need one line code.
  • Build-In powerful component event communication.
  • Real-Time track Component link 💫 .
  • Consider MVx, VIPER (etc.) module as component, using the same transition and event API.
  • Add plugin mechanism for custom extension other design pattern module and URL Route.
  • Add URL interceptor for intercept special URL before transition.

🍺 Thanks VIPER!

VIPER Design Pattern

Component Architecture

Component Architecture




Swift Demo

see Lego-swift

Complete project

see BDJProjectExample



  • Xcode 7.0+
  • IOS 6.0+

4.x Release

XFLegoVIPER 4.x is now available (July 2017). 🎉 It's now add Swift (all version) language support. 🎉



To integrate XFLegoVIPER into your Xcode project using CocoaPods, specify it in your Podfile:

platform :ios, '8.0'
use_frameworks! # for Swift!!!

target '<Your Target Name>' do
    pod 'XFLegoVIPER', '~> 4.0'

Import the XFLegoVIPER.h umbrella header.

  • With use_frameworks! in your Podfile
    • Swift: import XFLegoVIPER
    • Objective-C: #import <XFLegoVIPER/XFLegoVIPER.h> (or with Modules enabled: @import XFLegoVIPER;)
  • Without use_frameworks! in your Podfile
    • Swift: Add #import "XFLegoVIPER.h" to your bridging header.
    • Objective-C: #import "XFLegoVIPER.h"

❤Using Template❤

Now you can use template file to create a module which make of stuff class as fast as possible.

Too complicated? See Video

1.Install the templates

Xcode templates can be found in the repository's /Template/Architecture folder. To install them, open your terminal and run:

mkdir -p ~/Library/Developer/Xcode/Templates/
cp -R Template/Architecture ~/Library/Developer/Xcode/Templates/

2.Using xcode create module files

  1. Quit Xcode and open again
  2. Right click a group, select New File...
  3. Scrolling to Architecture Section, double click VIPER or MVVM item
  4. Input module name (you need add class prefix), and next, final click create action

3.Fix blue folder issue

we have blue folder under select group, what's wrong? Let's fix it:

  1. Right click blue folder, select Show in Finder
  2. Back to Xcode, right click blue folder again, select Delete->Remove References
  3. Back to opened Finder, drag new-folder to Xcode under a group

OK! It Work!

VIPER Module

XFLegoVIPER Module Layer


3.x/4.x(Objc) | 4.x(Swift)

Change log

see change log


iOS Architecture Patterns English | Chinese

Architecting iOS Apps with VIPER English | Chinese


yizzuide, [email protected]

QQ Group:450518005


Code Contributors

This project exists thanks to all the people who contribute. [Contribute].

Financial Contributors

Become a financial contributor and help us sustain our community. [Contribute]



Support this project with your organization. Your logo will show up here with a link to your website. [Contribute]


XFLegoVIPER is available under the MIT license. See the LICENSE file for more info.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
objective-c (10,939
swift (7,699
ios (3,582
modular (116
viper (39