getting-started.md

You can run bluegenes locally for development purposes. Here's what the local setup should look like.

System Requirements

• Java 6+
• Leiningen 2.5+
• node 7+ (you can check your version using node -v). We recommend installing node using nvm
• Required: The InterMine you point BlueGenes at must be running InterMine 1.8 or later; ideally 2.0.

Download dependencies.

npm install

Compile the CSS

We use less to write our styles. In order to run BlueGenes you'll need to compile the less, using

lein less once

Or, if you'll be making lots of style edits and don't want to type lein less once every time you make a change, you can automatically recompile the css file whenever it changes, using:

lein less auto

Note that you won't see a prompt telling you when it's complete if you use lein less auto - but the browser page will automatically refresh so you'll know when it's done.

Start the process to reload code changes in the browser:

lein figwheel dev

Start the web server:

In another terminal, run the following

If you have Java 8 or lower:

lein with-profile +dev run

Java 9+:

lein with-profile +java9 figwheel

Then visit http://localhost:5000/ (or whichever port you specific in config.edn)

Run tests:

lein clean
lein doo phantom test once

The above command assumes you will use phantomjs (already declared as a Node.js development dependency). However, please note that doo can be configured to run cljs.test in many other JS environments (chrome, ie, safari, opera, slimer, node, rhino, or nashorn).

What next?

Once you're happy with any edits you've made, you probably want to check that it all works the same in a minified prod build. See production builds for info on deploying and testing a minified build.