Need help with starboard?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

204 Stars 18 Forks MIT License 112 Commits 8 Opened issues


onboarding, offboarding, or crossboarding made easy

Services available


Need anything else?

Contributors list

Starboard Build Status

WARNING: This code is an early-access release; we wrote it for ourselves and it still harbors a lot of Herokuisms. You will probably have to adapt it to your needs if you want to use it.

Starboard is a tool which creates Trello boards for tracking the various tasks necessary when onboarding, offboarding, or crossboarding employees. We use Trello extensively within Heroku, and Starboard makes it easy to manage HR transitions from inside Trello.

The tasks themselves are authored as markdown files. When you run starboard, it resolves which tasks are relevant for the given employee and target team, and creates a new Trello board from the relevant markdown files.

Because the files are markdown (and stored in git), they're accessible to everyone in the company. Improvements to onboarding can come from anyone in the form of a pull request to the relevant guide.

What does the UI look like?

Well, at Heroku, the frontend for creating boards looks like this:

Starboard Web UI Screenshot

How do I use it to create a Trello board?

Go to your deployed instance of Starboard, authorize with Trello, fill out the form and twiddle your thumbs while Starboard does its thing. When it finishes, you'll be redirected to your shiny new board.

Where is it getting the data from?

Starboard depends on a specially-structured GitHub repository which contains the markdown guides. See the template repository for an example and more documentation.

Starboard on Heroku

First, you'll need to create a GitHub repository containing the guides themselves. A template dir is provided. More information about the format of this repository is available in docs/


Starboard limits access by means of checking that the user has access to a specific Trello organization.

Warning: users who don't have access to the Trello org cannot create boards, but can still access the starboard frontend and nothing prevents them from reverse-engineering the requests to fetch the raw markdown guides. If this is a problem for you, limit access to the webapp by other means.

Deploy the app

Deploy to Heroku


You can use the old way and - Clone the code - Create an app - Add a memcached add-on - Push the code

You will also have to set a few configuration variables.

Config variables

    The trello organisation where the boards are created.
    The trello API key that can be found at
    A GitHub access token to get the guides out of your repository. You can create an OAuth app and generate a token or use a personal access token. Please check and use a private repo if you want to keep your content private.
    identifier of the GitHub repository containing your guides.
    A generated secret used to create a web hook on GitHub to auto update the guides.

Register a Webhook on GitHub

In order for starboard to be aware of updates to your guides, you will need to create a webhook.

Follow the GitHub guide about webhooks creation and add a hook for

First deploy

When you first deploy the app, you'll need to bootstrap the cache. There are two ways to accomplish this:

  1. Update your guides after installing the app and setting up the webhook. The update will cause Starboard to cache your guides.

  2. Trigger the same mechanism, but manually:

    curl -X POST

Ready to create boards

Hooray! Head over to
and go to town.

GitHub token renewal if you created an OAuth application.

You can regenerate an access token via this curl command.

curl -vvv -X POST -H "Content-type: application/json" -u  -H "X-GitHub-OTP: <2FACODE IF YOU 2FA>" -d '{"scopes":["repo"],"note":"starboard access","client_id":"","client_secret":""}'

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.