Skip to content
This repository

IB Outlets for rubymotion


RubyMotion interface builder support (yes, with outlets)

Build Status

Change Log


Add this line to your application's Gemfile:

gem 'ib'

And then execute:

$ bundle

Or install it yourself as:

$ gem install ib

Or use RubyMotion templates by @infiniteNIL

In your Rake file:

require 'motion/project'

# if you use bundler
require 'bundler'

# if you are not using bundler
require 'rubygems'
require 'ib'

Motion::Project::App.setup do |app|
  # ...


Manual Way

extend your class with IB module

class HelloController < UIViewController
  extend IB

  # define ib outlet
  outlet :title, UILabel # @property IBOutlet UILabel * title;
  outlet :untyped_label  # @property IBOutlet id untyped_label;

  # define ib outlet collection
  outlet_collection :labels, UILabel # @property IBOutletCollection(UILabel) NSArray * labels;

  # define ib action
  def someAction sender

NOTE: If you include methods and attributes from module, you can use ib_outlet and ib_action to make them visible in Interface Builder

module TouchLogger
  outlet :my_button, UIButton

  def controlTouched sender
    puts "touched"

class LogController < UIViewController
  extend IB

  include TouchLogger

  ib_outlet :my_button
  ib_action :controlTouched


Generators Way

Generate controller with folllowing command:

ib c Hello UIViewController \
  --outlets scroller:UIScrollView btn_hello: \
  --actions say_hello \
  --accessors data_source

The generated file:


class HelloController < UIViewController
  extend IB

  attr_accessor :data_source

  ## ib outlets
  outlet :scroller, UIScrollView
  outlet :btn_hello

  def say_hello(sender)
    # TODO Implement action here


Using Interface Builder

Running rake ib:open will create a ib.xcodeproj in the root of your app and open XCode. You can create Storyboards or nibs, and save them in your resources directory in order to be picked up by RubyMotion.

Everytime you make a change in your ruby files (like adding a new outlet or action method) you have to run rake ib:open in order to let Interface Builder see the changes.

Tip : add ib.xcodeproj to your .gitignore

How it works

This gem parses your Ruby code and generates two Objective-c files (Stub.m and Stub.h) which are populated with the classes, methods and outlets you have defined. This is necessary for Interface Builder to bind outlets and actions to your code.

Sample app

Here is sample app

  1. clone it
  2. run bundle
  3. run rake ib:open to change story board
  4. run rake to run app in simulator

Note : this app is build for iOS 6.0

Another Sample app

Here is another sample app

OS X Sample app

Here is OS X sample app

You can play around with it in the same way as the Sample app above. This sample uses a single xib file rather than a storyboard.


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request
Something went wrong with that request. Please try again.