diff --git a/README.md b/README.md index 1eda46912..857eb0327 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,8 @@ # Flotilla Flotilla is the main point of access for operators to interact with multiple robots in a facility. The application -consists of a [frontend](frontend/README.md) in React, a [backend](backend/README.md) in Python using the FastAPI -framework and a Mosquitto MQTT Broker. +consists of a [frontend](frontend) in React, a [backend](backend) in Python using the FastAPI +framework and a Mosquitto MQTT [Broker](broker). ## Setup @@ -12,6 +12,8 @@ For development, please fork the repository. Then, clone the repository: git clone https://github.com/equinor/flotilla ``` +Please see separate installation and setup guides for [frontend](frontend), [backend](backend), and [Broker](broker). + ## Run with docker Install docker using the [official documentation](https://docs.docker.com/engine/install/ubuntu/). @@ -26,17 +28,23 @@ sudo apt install docker-compose Build the docker container: ``` -sudo docker-compose build +docker-compose build ``` Start Flotilla by running: ``` -sudo docker-compose up +docker-compose up ``` or ``` -sudo docker-compose up --build +docker-compose up --build ``` + +## Contributing + +We welcome all kinds of contributions, including code, bug reports, issues, feature requests, and documentation. The preferred way of submitting a contribution is to either make an [issue](https://github.com/equinor/isar/issues) on github or by forking the project on github and making a pull requests. + +We write our commit messages according to [this guide](https://cbea.ms/git-commit/).