Motiontemplate

A clean RubyMotion project for quickly templating a styled application. RubyMotion Template

Download .zip Download .tar.gz View on GitHub

MotionTemplate

Build Status

Motion Template is a strightforward clean template for loading useful gems and skinned UI items. It's an excellent starting point for building your RubyMotion application. Simply strip out the features you don't need, and start implementing your app on this robust RM 2.0 template!

Install and Use this Template (Requires RM >= 2.3)

Create your new project from this template straight off of github!

$ motion create --template=git@github.com:IconoclastLabs/MotionTemplate.git

External Dependencies

The motion-rubberstamp gem relies on imagemagick and ghostscript, which can easily be installed via Homebrew:

$ brew install imagemagick

$ brew install ghostscript

Otherwise you'll need to comment out this gem.

GEMS

  • Teacup v2 - DSL for CSS-esque styling.
  • Bubblewrap - A collection of (tested) helpers and wrappers used to wrap CocoaTouch code and provide more Ruby like APIs.
  • Sugarcube - Simplification and shortcuts for iOS annoyances and verbosity.
  • Sweettea - Coercion and further Sugarcube magic/shortcuts in Teacup's DSL via Handlers.
  • Motion Awesome Print - Awesome print ap for RubyMotion. Colorized, Multi-line, Detailed print inspection.
  • Motion Awesome - The impressive icon set of Font-Awesome imported and ready to use inside of your Motion Project.
  • Motion-Rubberstamp - Run rake rubberstamp:run to stamp your versions right onto your icons for dev!

Conventions

  • Splash Screen - Implemented Splash screen logic, ready to go!
  • iOS 6 Autolayout - Using Auto Layout via Teacup's constrains to help the UI to flow and scale as needed.
  • AppProperties Class - The rakefile has been generalized and most configurations are in the app_properties.rb for clarity. Don't forget to point provisioning to a symlink (allowing multiple users for the same source).
  • Custom UI Skins - Using custom styling so you can quickly change the application flavor.
    • Base Leather
    • Basic
    • More to come!? Fork us!

MotionTemplate ScreenshotMotionTemplate Settings

Themes

Change the style in AppProperties so you can implement multiple themes. Here's setting the self.root_style to :basic MotionTemplate Basic

Requirements

  • Requires RubyMotion 2.0 (see Tag for rubymotion 1.x if you are not 2.0 - Not a template just a project)
  • This is a RubyMotion Project with all dependencies listed in the Gem file.
  • iOS 6 or greater is mandatory If you'd like to use this project for older iOS releases you'll need to remove all autolayout and replace with hardcoded widths/heights/tops/lefts.
  • imagemagick and ghostscript Are needed if you plan on using Motion-Rubberstamp to stamp your icons.

Copyright License

The graphical assets are not permitted for redistribution. We bought the license to use them here, and their extraction or reuse is not permitted under our purchase license.

The code is completely open under MIT License.

See LICENSE file for full details.

Requests and Credits

As always we're opent to pull requests/issues!

Special thanks to Colin T.A. Gray for answering questions and writing/maintaining some of the key gems in this project.

The outdated but original blog post on this Template can be found here: Blog on the original template: http://iconoclastlabs.com/cms/blog/posts/rubymotion-template

If you'd like to send inquiries, compliments or criticisms you can find us here contact