/firecloud-ui

Primary LanguageClojureBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

firecloud-ui

FireCloud user interface for web browsers.

https://firecloud.dsde-dev.broadinstitute.org/

https://firecloud.dsde-staging.broadinstitute.org/

Technologies

ClojureScript is used for the UI.

We use the Leiningen build tool to manage ClojureScript dependencies.

The code incorporates usage of react-cljs which is a ClojureScript wrapper for React.

Figwheel replaces the running JavaScript within the page so changes are visible without a browser reload. More information here. This video gives some insight into the productivity gains available when using this technology (up to about 15:00 is all that is necessary).

Getting Started

see https://github.com/broadinstitute/firecloud-environment

Build Options

Build once:

./script/dev/build-once.sh

Watch files and rebuild whenever a file is saved:

./script/dev/start-auto-build.sh

Watch files, rebuild, and reload changes into the running browser window:

./script/dev/start-hot-reloader.sh

For this build, you must be viewing the application via HTTP, not HTTPS. HTTPS is not supported by Figwheel.

This can take around 20 seconds to completely start. When ready, it will display the following message:

Prompt will show when figwheel connects to your application

To connect, reload the browser window. The prompt should appear less than ten seconds after you reload the page. If it is not connecting, make sure to check the JavaScript console for error messages.