HTML5 game framework for web and iOS
Branch: master
Clone or download
tonistiigi Merge pull request #155 from Vlad-UA/master
Advanced optimizations with additional option for longer names renaming
Latest commit 99c8b9f Jun 1, 2015
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin advanced optimizations additional option -- longer names to figure ou… May 31, 2015
lime Merge pull request #144 from neobutter/master Jun 1, 2015
.gitignore First public commit Jan 19, 2011
AUTHORS Update AUTHORS Dec 16, 2013
LICENSE First public commit Jan 19, 2011
Makefile Demo games debug building support Apr 23, 2013 Update Jul 22, 2013


##Getting started:

###Mac OS X and Linux users:

  • Requirements: Python 2.6+, Git
  • 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 bash from (if not already installed). While installing select "Use Git Bash only" and Unix style line endings.

  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 Python3 should work fine but 2.7.x is recommended.

  5. Launch Git Bash

  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 run:

    echo "export PATH=$PATH:/c/Python27/" >> ~/.bashrc

    This is the longer version if you use Command Prompt instead of Git bash:

    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