Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Ruby CoffeeScript
Tag: v0.4.0

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.


A MVC framework for Titanium Developer.

The purpose of this framework is to organize your Titanium Developer projects in a Model-View-Controller (MVC) pattern.


Current Version: 0.3.1

Fixed Bug

Fixed issue with model generator and the name attribute

API is locked

From this point on we will not be changing the API to move to stability. There were some changes between 0.2 and 0.3. From this point on there will not be any more api changes, so if your app works with 0.3 it should work with all later versions.


  • Multiple App Support

Extended the Chester namespace from Base, this will enable the developer to add multiple applications to the Chester namespace and run routes between the apps.

  • Created an alias of '_' underscore for find, which will make the lines more readable. ex:


instead of

  • Created a names array on the base class to make it easier to find children objects

  • Updated generators with new changes


Titanium Developer is an awesome JavaScript SDK for building mobile applications, but there are no conventions on how to organize your code. We build web applications using Ruby on Rails, and being able to organize our iPad applications using the same patterns will enable us to process and maintain our software projects more effectively.


Added Helper generator, also changed the convention of the controller actions and model methods to start with an underscore. This will allow us to use new and create without worrying about javascript conflicts.


  • Finish Generator Test Coverage
  • enhance brew command to create one javascript file
  • Add testing library. Suggestions?


  • node.js
  • coffeescript


gem install chester


rake spec

Add to any Titanium Developer Project

Just run chester install, and it will create the file in your Resources folder.

cd ./Resources
chester install

Easy to compile the coffee files to javascript

This command compiles your coffee script into JavaScript.

cd ./Resources
chester brew

Easy to generate models | views | controllers

cd ./Resources
chester generate model person
chester generate controller people
chester generate view people index
chester generate helper people

These generators will make the following objects:

  • models
class Person
  # Insert your code here
Chester._('app').Models.add(new Person('Person'))

Just a quick run down on what is going on here: in order for chester to know your model, you MUST have an attribute called name. This attribute (name) will register the model to the application object. Chester will then be able to find your model whenever you request it.

  • controllers
class PeopleController extends Chester.Controller

# Register Controller to application
Chester._('app').add(new PeopleController('PeopleController')) 


Just like with the model, the controller needs to have an attribute called name. That is the actual name used for Chester to recognize the controller.

  • views
    • people
class PeopleIndex extends Chester.View
  render: (params) ->
    # TODO: add your presentation code here.

  # Register view to Patients Controller
Chester._('app')._("PeopleController").add(new PeopleIndex("index"))

Include the framework | models | views | controllers in app.js

// Include MVC Framework

// Register Controllers

// Register Models

// Register Views



  • Simple Example and locked API


  • Full Test Suite


  • Complete Web Site Documentation


  • Complete working JQuery Example
  • Complete working Titanium Example


  • Add a plugin module


The object hierarchy is very straight forward. Chester has a base object which has an add method and a find method.

  • base object

    • has a collection called children
  • Methods:

    • add : adds an object to the children array
    • find : locates and returns the object based on the name attribute


This is the core class definition that all other classes inherit.


This objects children are controllers. With the add method you can add new controllers to this object. With the find method you can locate the controller by the name of the controller.

Add and Find Example:

  • Chester.Application.find("PeopleController").add(new PeopleIndex())

There is another array of objects attached to this class called models. These are basic classes that can added to the Models array.


This object's children are views. These are not the same as views in Titanium. These are simple JavaScript classes that are used to contain the user interface code to manage your mobile application.


This will be the most confusing class because the UI objects in Titanium are user views. The Chester views are more like code containers that help isolate your user interface code from your business logic and domain logic.

This is the main routing method that makes the whole application work. It takes the following parameters as a JavaScript object.

  • Controller: string,
  • Action: string,
  • Params: object

This method simply finds the controller and executes the action method on the controller, passing the params object as the parameter.

Chester is built using coffee because it is much easier to maintain. But, you don't need to use coffeescript to use Chester! You can use JavaScript just fine.

Get Involved

  • Submit a pull request!
  • Report an issue on using #Ti.chester
Something went wrong with that request. Please try again.