Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

A thin library on top of the HTML canvas element. The API is modeled after PyGame.

Fetching latest commit…


Cannot retrieve the latest commit at this time

Octocat-spinner-32 docs
Octocat-spinner-32 examples
Octocat-spinner-32 lib
Octocat-spinner-32 tests
Octocat-spinner-32 utils
Octocat-spinner-32 .gitignore
Octocat-spinner-32 package.json


GameJs is a JavaScript library for writing 2D games or other interactive graphic applications for the HTML Canvas

Its API is modeled after the successful PyGame library


If you downloaded the git version, you will have to build the GameJs JavaScript file. Go to the GameJs directory and execute this in a unix shell or in git bash:

$ ./

See the examples/skeleton/ directory for a minimal GameJs app. We recommend you also use this as the scaffolding if you want to create a new game yourself.

Note that you need to run the examples via http:// (not file://) unless you use Firefox or Safari. One trivial, cross-plattform solution to serve a directory via http is this executable:

Bundle your application for production

To wrap your own game's JavaScript files into one single file, use ./wrap-directory ./path-to-your-app/javascript/. You can also add a second argument compress to optionally minify the resulting JS file.

This will produce one file gjs-app-wrapped.js holding all GameJs modules as well as your application code. You can then remove the <script> lines loading yabble & gamejs-wrapped and should instead only load the gjs-app-wrapped.js file.

More Help

See the GameJs Website for more help or drop us an email in the Mailing List.

Check the docs folder of your GameJs installation.

Example application can be found in the examples/ directory.

GameJs Development

In production, an application uses a bundled JavaScript file which contains all GameJs modules (usually called gamejs-wrapped.js). This is what all the examples do.

Thus if you modify the files below ./lib your changes won't show up in the examples. You have two options to hack on GameJs:

  • rebundle the files with the ./ command
  • directly use the unbundled library files

To use the unbundled JavaScript files directly, remove the <script> line including gamejs-wrapped.js from your index.html and instead create symbolic links of everything below ./lib into your applications javascript/ directory:

$ cd path-to-your-app/javascript/
$ ln -s ~/gamejs/lib/*

Your application should now transparently load the single modules instead of the bundle.

Unit Tests

We use QUnit for the GameJs unit tests. Execute them by opening tests/index.html.


For the JavaScript documentation system, RingoJs must be installed on your system. This bash file will take care of rewriting the documentation into docs/api/:

$ ./
Something went wrong with that request. Please try again.