Latest 1.1.2
License MIT
Platforms ios 7.0, requires ARC

CI Status

// XUI in a single line
[XUIListViewController presentFromTopViewControllerWithDictionary:@{  @"items": { @"default": @YES, @"label": @"Feature", @"cell": @"Switch", @"key": @"switch1" } }];

Make a configuration UITableView in 5 minutes? Let’s do it!

XUI is a drop-in replacement for "Settings Application Schema" on iOS. It allows application to show preferences view controller by creating a simple configuration bundle (much like "Settings.bundle").


  • [x] Data Persistence (NSUserDefaults / Custom Adapters)
  • [x] Localized Strings / Image Resources
  • [x] Custom Cells (Runtime)
  • [x] Notifications


XUI provides more components than private framework "Preferences.framework":

  • [x] Group
  • [x] Link (Child Pane)
  • [x] Switch
  • [x] Button (Action)
  • [x] TextField
  • [x] Radio / Checkbox Group
  • [x] Segment Group
  • [x] Single Selection Option List
  • [x] Multiple Selection Option List
  • [x] Ordered Multiple Selection Option List
  • [x] Slider
  • [x] Stepper
  • [x] DateTime Picker
  • [x] TitleValue
  • [x] StaticText
  • [x] Textarea
  • [x] Image
  • [x] Editable List (Strings)


// to specify the path for Settings.bundle
NSString *bundlePath = [[NSBundle mainBundle] pathForResource:@"Settings" ofType:@"bundle"];

// to specify the root entry for that bundle
NSString *xuiPath = [[NSBundle bundleWithPath:bundlePath] pathForResource:@"Root" ofType:@"plist"];

// present or push it!
XUIListViewController *xuiController = [[XUIListViewController alloc] initWithPath:xuiPath withBundlePath:bundlePath];
XUINavigationController *navController = [[XUINavigationController alloc] initWithRootViewController:xuiController];
[self presentViewController:navController animated:YES completion:nil];
NSString *xuiPath = [[NSBundle bundleWithPath:bundlePath] pathForResource:@"Root" ofType:@"plist"];

// directly present XUI from the top most view controller
[XUIListViewController presentFromTopViewControllerWithPath:xuiPath];


If the key defaults is not set, configuration will be saved to Standard User Defaults.

NSNumber *enabled = [[NSUserDefaults standardUserDefaults] objectForKey:@"enabled"];
[enabled boolValue];


Receive notifications named XUINotificationEventValueChanged from [NSNotificationCenter defaultCenter].


XUI Theme can be configured in theme dictionary.


Create custom adapter to read the interface schema from any format you like: plist, json, or lua. Adapter also handles data persistence and notifications.


To know if there is any invalid part in our interface schema…

Custom Cells

Inherit from XUIBaseCell then have fun with your own cells whether it is xib based layout or not. XUI will automatically load custom cells by runtime.

More Documentation


To run the example project, clone the repo, and run pod install from the Example directory first.



  • Xcode 7 or above
  • iOS 7 or above
  • Objective-C (ARC)
  • iPhone / iPad compatible.


XUI is available through CocoaPods. To install
it, simply add the following line to your Podfile:

pod 'XUI', :git => ""


Lessica, [email protected]


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

Related Projects

Latest podspec

    "name": "XUI",
    "version": "1.1.2",
    "summary": "A configuration based native TableView UI.",
    "description": "XUI is a drop-in replacement for "Settings Application Schema" on iOS.",
    "homepage": "",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    "authors": {
        "Lessica": "[email protected]"
    "source": {
        "git": "",
        "tag": "1.1.2"
    "platforms": {
        "ios": "7.0"
    "requires_arc": true,
    "source_files": "XUI/Classes/**/*"

Pin It on Pinterest

Share This