HTML5 game framework for web and iOS
JavaScript Python
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 246 commits behind digitalfruit:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


##Getting started:

###Mac OS X and Linux users:

  • Requirements: Python 2.6+, Git, SVN
  • Clone the git repo (you have probably already done that): git clone git://
  • bin/ --help
  • bin/ init
  • bin/ create helloworld

  • open ./helloworld/helloworld.html in the browser
  • study/tweak the source

###Windows users:

If you consider yourself advanced user and know how to use Git/Python you are probably better off reading through Mac/Linux guide and choosing your best alternative tools/methods yourself. If not then follow this step-by-step route.

  1. Download and install Git client from (if not already installed). While installing select "Run Git from the Windows Command Prompt".

  2. Clone lime git repo or download zip package from

  3. Extract the contents to suitable place on your hard drive. Next examples will use c:\ as the base path.

  4. If you don't have python download and install it from

  5. Launch Command Prompt (or PowerShell)

  6. Check if you have python installed on your global path by running: python --version

    If this returned error you have to add it to your global path or use full path to binaries in next steps.

    To add python to your global path:

    1. Open Control Panel -> System and Security -> System -> Advanced system settings
    2. Under Advanced tab select Environment Variables...
    3. Under system variables find variable named Path.
    4. Select it and click Edit.
    5. Append semicolon and path to the folder you installed python to the value. For example ";C:\Python27"
    6. Press OK and OK
    7. Restart Command Prompt
    8. Try if it works now
  7. Move to lime base folder cd c:\lime

  8. python bin/ --help

  9. In similar pattern continue from Mac/Linux tutorial from step 3

##Browser support:

  • Current: Chrome, Safari 5, Firefox 3.6+, Opera, IE9, Mobile Safari
  • Soon: Android, Blackberry Playbook
  • Maybe: WebOS


Closure Library:

Closure Compiler:

Closure Templates:


Canvas 2D API spec:

WebGL spec:

Closure book:

Closure video from Google I/O 2010:

Known issues:

  • build problems when directories contain spaces
  • ...add your issues to the github page

Browser issues:


  • Custom WebGL context
  • Sprite fill
  • Web-app installing tutorial
  • Unit tests(partial)
  • Some basic fallback for non supported browsers


  • Strokes
  • More shapes
  • Box2D basic integration
  • Different shape masks
  • More transitions
  • Better audio support
  • Local cache support
  • Other mobile platforms support(Android,WebOS,Playbook)
  • Data support(endtable?)
  • Radial Gradients
  • Resources loading
  • Preloader
  • WebGL Renderer
  • Dev console
  • Tiles
  • Scrollers
  • Menus
  • UI controls
  • Video support
  • Markup with templates
  • Integration with MoRe