node package manager


quickly bootstrap Blockly instances in node and browser

create-blockly makes it easy to create Blockly instances in both node and the browser (using browserify).

In the browser, Blockly will always be installed in the most flexible and isolated way, using the Blockly's resizable iframe method.

First, make sure you have node and npm installed on your machine.

Create a new directory with create-blockly installed:

mkdir MyProject
cd MyProject
npm install create-blockly

Create "browser.js" that instantiates Blockly:

var createBlockly = require("create-blockly");
var Blockly = createBlockly({
  // This is where the iframed resizable Blockly will be embedded. 
  container: document.getElementById("my-editor"),
  // Make the default set of blocks available, with English translations. 
  // (you can choose other translations like "create-blockly/Msg/zh_tw") 
  extensions: [
    require("create-blockly/Blocks"), // Blockly.Blocks 
    require("create-blockly/Msg/en"), // English translations 
    require("create-blockly/Javascript"), // Blockly.Javascript exporting 
  // This is the toolbox that defines which blocks are visible. 
  toolbox: document.getElementById("my-toolbox")
// Whenever this Blockly editor changes, log the generated Javscript code. 
// More Blockly documentation at 
Blockly.addChangeListener(function() {
  var code = Blockly.Javascript.workspaceToCode();

Create the associated "browser.html" to load the Javascript:

    <script type="text/javascript" src="browser.js"></script> 
    <!-- This is where the iframed resizable Blockly will be embedded. -->
    <div id="my-editor"></div>
    <!-- This is the toolbox that defines which blocks are visible. -->
    <!-- -->
    <xml id="my-toolbox" style="display:none">
      <category name="Control">
        <block type="controls_if"></block>
        <block type="controls_whileUntil"></block>
      <category name="Logic">
        <block type="logic_boolean"></block>
        <block type="logic_operation"></block>
      <category name="Text">
        <block type="text"></block>
        <block type="text_print"></block>

Install helpers for the server:

npm install express enchilada

Create the "server.js" to serve the demo:

var express = require("express");
var enchilada = require("enchilada");
var app = express();
console.log("Running demo on localhost:1337")

Run the server and open localhost:1337 in your browser:

$ node server.js
Running demo on localhost:1337
  • Allow checking out specific revisions of Blockly source from svn
  • Allow user to specify their own copy of Blockly source

Just make a pull request :)