Tiny tool to help you write bl.ocks in ES6
JavaScript HTML CSS
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
src Format everything with standard Dec 15, 2017
template update d3 to v5 Jun 15, 2018
.gitignore Update gitignore Jan 4, 2018
LICENSE Create LICENSE Sep 26, 2016
README.md Update README.md Dec 15, 2017
package-lock.json 2.2.13 Jun 25, 2018
package.json 2.2.13 Jun 25, 2018
yarn.lock Update lock files May 24, 2018



Scaffold and serve html, specifically focused on bl.ocks. Go from idea to block from the comfort of your own text editor.



bl.ocks is a great tool! But using the Gist site as a text editor is no fun. This little tool helps you make blocks just a tiny bit faster:

  • one command, blockup, scaffolds and serves a new block
  • write ES6 and it gets compiled down to ES5
  • write Stylus and it gets compiled to CSS (because you have a finite number of keystrokes)
  • browser reloads on file change
  • errors during compilation pop up in notification bar
  • check for missing expected files with blockup check
  • publish directly to gist with blockup publish

That's it for now. It probably won't grow beyond this. But if you have an idea, I'd like to hear it!

now with module imports!

  • Stop dumping all your code in script.js! - now you can do this in blockup:
import draw from './draw.js'


Usage: blockup <command>

  new      scaffold and serve a new block (default if directory is empty)
  serve    serve current block (default if directory is not empty)
  check    check if any expected files are missing
  publish  publish this block as a gist via gistup

  -h, --help  Show help                                                [boolean]
  --version   Show version number                                      [boolean]

great! but is there a way to upload to gist from the command line?

Yes! You can use the built-in command blockup publish for most use cases. If you need something more configurable, you can also try using gistup directly.


npm install -g blockup

ugh there's an error

Great! Add your error to https://github.com/gabrielflorit/blockup/issues so we can improve this tiny tool.