Stello

A static content generator using Trello as a backend.

Go to the code »

What's This Stello Thing?

Stello is a static content generator which uses Trello as a backend. So... what does that actually mean? We like to think of Stello as "map-reduce" for Trello cards. For example, you might create a snippet of HTML for earch card in a board then combine those snippets into a reveal.js presention.

That's just one example, in general Stello lets you easily manipulate and combine the data behind your Trello boards to produce anything from static sites and blogs to beautiful charts and graphs.

Getting Started

  1. Install Stello

    Stello runs on Node.js, you'll need to install that first if you don't have it already.

    Then simply use the Node.js package manager, npm, to get Stello. Npm should ship with Node.js.

    npm install -g stello

    Voila! If all worked correctly you should now have access to the stello command.

  2. Gather Your Trello Info

    Stello users your public developer key and an application specific token to pull data from your Trello boards.

    After authenticating with Trello visit this page to grab your public and private developer keys. Note that we will only be using your public key.

    Once you have a public key, paste it into the form below to get an appliation token for Stello:

    You're ready to build with Stello :).

  3. Start Building with Stello

    Stello ships with two sub commands: init and build. Run:

    stello init

    To prepare your workspace. You will be promped to provide your public developer key and an api token for Stello to use. Finally, Stello will ask you for the URL of the board you want to work with.

    That's it! Stello added a number of template files to your working directory in a ./src folder. Check out the project README for descriptions of what these files do.

    The command:

    stello build

    Will run the data from your board through the templates in ./src and store the resulting files in a ./dist folder.

Licensing

Stello's source, this site, and in general any code put out by the stellojs organization is released under The MIT Licenses.

Stello and the stellojs organization are not affiliated with Trello, Inc. in any way. But we think they're pretty cool.