Mainflux.mainflux/ui/README.md

GUI for Mainflux in Elm

Dashboard made with elm-bootstrap.

Install

Docker container GUI build

Install Docker and Docker compose, cd to Mainflux root directory and then

docker-compose -f docker/docker-compose.yml up

if you want to launch a whole Mainflux docker composition, or just

docker-compose -f docker/docker-compose.yml up ui

if you want to launch just GUI.

Native GUI build

Install Elm and then run the following commands:

git clone https://github.com/mainflux/mainflux
cd mainflux/ui
make

This will produce index.html in the ui directory. Still in the mainflux/ui folder, enter

make run

and follow the instructions on screen.

NB: make does elm make src/Main.elm --output=main.js and make run executes elm reactor. Cf. Makefile for more options.

Configuration

Open the src/Env.elm file and edit the values of the env record.

Contribute to the GUI development

Follow the instructions above to install and run GUI as a native build. In src/Env.elm change a url field value of the elm record to http://localhost:80/ (trailing slash / is mandatory). Instead of make run you can install elm-live and execute elm-live src/Main.elm -- --output=main.js to get a live reload when your .Elm files change.

Launch Mainflux without ui service, either natively or as a Docker composition. If you have already launched Mainflux as a Docker composition, simply cd to Mainflux folder and run docker-compose -f docker/docker-compose.yml stop ui. Please follow the guidelines for Mainflux contributors.