A FLINT client, written in Vue, to provide an awesome user interface for configuring simulations using the FLINT.Cloud APIs
Table of Contents
This project provides an intuitive way for new to explore some preconfigured FLINT modules, including the Generic Budget Carbon Model (GCBM), in order to better understand how the FLINT system works. Our client is written as a Web application and can be used in a local or remote environment. Please contact us if you'd like help deploying your cloud instance or customizing the client.
In order to use and work on this project you need to install Docker for running the Docker image and Yarn to run the Vue app locally.
You can install Docker following the download's instructions.
In order to install Yarn, open a terminal and type:
npm install -g yarnTo set up this project locally follow the below procedure:
- Pull the below docker image to run
flint.example:
docker pull shubhamkarande13/flint.example:bionic- Clone FLINT.UI repository:
When using submodules the installation code needs to be:
git clone --recursive https://github.com/moja-global/flint-uiOr if you've already initialized the repository without the submodule
git submodule update --init --recursive- Now get inside the repository directory and build the
docker-compose.ymlfile by following the below command:
docker-compose upThis will build all the docker images inside the docker-compose.yml file. It will take some time and after that, you can see all images list in the Docker app.
docker-compose.yml file is composed of three services i.e. flint.example.api, flint.gcbm.api, flint.ui.
Now you can start all the containers by clicking on the START button or using the command docker-compose up. You can also use the command docker start {name of the container} to start the only specific container.
All containers list will look like this in the Docker app:
If you want to shut down a specific container click on the STOP button of that specific container in the Docker app. You can also use the command line to stop a specific container by using the command docker stop {name of the container you want to stop}.
To shut down, the whole docker-compose.yml file and all services inside it then use the command docker-compose down.
You can also run
docker-compose.ymlin Detached mode. Detached mode, shown by the option--detachor-d, means that a Docker container runs in the background of your terminal. It does not receive input or display output. So the command for runningdocker-compose upin Detached mode isdocker-compose up -d.
- To view the UI please navigate to 127.0.0.1:8000. UI will look something like this:
Go through the Development Notes here..
To contribute to FLINT-UI:
Go through our contributing guidelines over here..
moja global welcomes a wide range of contributions as explained in Contributing document and the About moja-global Wiki.
- You can find FAQs on the Wiki.
- If you have a question about the code, submit user feedback in the relevant repository
- If you have a general question about a project or repository or moja global, join moja global and
- submit a discussion to the project, repository or moja global team
- submit a message to the relevant channel on moja global's Slack workspace.
- If you have other questions, please write to [email protected]
Thanks go to these wonderful people (emoji key):
 moja global 📆 |
This project follows the all-contributors specification. Contributions of any kind are welcome!
The following people are Maintainers, Reviewers, Ambassadors, or Coaches.
moja global 📆 |
- Maintainers review and accept proposed changes
- Reviewers check proposed changes before they go to the Maintainers
- Ambassadors are available to provide training related to this repository
- Coaches are available to provide information to new contributors to this repository
This project is released under the Mozilla Public License Version 2.0.