Sumocode Documentation

Getting Started

Sumocode is a code editor, focused on learning how to code in an easy way. You only need to write a few lines of code to have interactive scenes, or you can program simple games using the Sumolib API and a basic knowledge of JavaScript.


  1. The Navbar. It provides an easy access to import/export options and to publish the project as a ready-to-go package for the web.
  2. Run my code/Stop. Here you can run the code or stop your project. Every time you change any line of code you can simple press Cmd+S to save and run it.
  3. Quick access. Here you have a quick access to undo/redo on to check or uncheck the Autosave option.
  4. Code editor. Here you can directly edit your code using the Sumolib API as explained below.
  5. Project running. The result of running the code of the code editor on the left side.


You can export any project as .sumofile format. With this file you can share it to a friend/teacher or import it later if you want to continue on an upcoming coding session.


You can import any .sumocode file exported with the app. When it's loaded, you only need to save (Cmd+S) to run it.


If you are a PRO user, you can download your code in a package that is ready to be published as a webpage. The .zip file contains an index.html + CSS file + js file with the Sumolib included.


You can undo/redo the code you have written pressing the Quick access buttons or on the navbar Edit/Undo or Edit/Redo


If you have checked 'Autosave', it saves your code locally every time you edit it, so if you refresh your page or close your browser, your code will be the same when you come back to it. If you have it unchecked, you need to export it, and import it the next time you want to work on your project.

Code hinting

Sumocode will suggest some values to the sumo objects. In example, if you start by 'sumo.', you might want to use the sumo.background method.


Basic examples

One of the best ways to start learning is modifying some of the existing examples, if you go through to all of them you can see all the methods in action.

Learning game development

Making a game is not an easy task to start, but when you are comfortable with the API, we are sure you can start doing great interactive projects. Below you have some examples of simple games made with Sumocode to inspire you.

Memory game example

With less than 350 lines of code, you can play a 3D memory game with sounds. We use some JS basic concepts like Arrays, for and if statements, and we create our own methods and variables to be called from the Sumocode functions. Beyond that, the rest is to use your imagination and the Sumolib API.

Math Dummy game example

This game is a little more complex than the Memory game, but it has less than 500 lines of code. We use some JS basic concepts like Arrays (with multiple dimensions), switch, for and if statements, logic operators like && (AND) and || (OR) and we create our own methods and variables to be called from the Sumocode functions.