Skip to content

Latest commit

 

History

History
57 lines (32 loc) · 2.19 KB

README.md

File metadata and controls

57 lines (32 loc) · 2.19 KB

Flare Documentation

pipeline status

This is the source repository for the Flare docs site.

Run locally

To get started, you have two main options for setting up your development environment: utilizing a Docker container or a manual setup. While both methods are effective, we recommend using a Docker container to avoid version discrepancies with the rest of the team.

Using Docker Container

  1. Download and install Docker Desktop

  2. In the command line navigate to the repository folder and build the docker container with the command:

    docker compose up --no-start
  3. After this step, You can run it from the Docker Desktop app. Open Docker Desktop, navigate to the Containers section, and run the docs-private container.

    Start Flare Docs in Docker Desktop

  4. To see the console logs or errors, open the Docker Desktop app and go to the docs-private container details under the containers section.

    Open Container details in Docker Desktop

    Check all the warnings because the automatic build process will not accept them when creating a pull request.

    Container details in Docker Desktop

  5. From your browser, go to URL localhost:8000 to see the documentation page.

  6. Press the stop button in the Docker Desktop app to stop it.

    STOP Flare Docs in Docker Desktop

Manual Setup

  1. Download and install Python.

  2. Install PIP, the Python package manager.

  3. Install required packages.

    pip install -r requirements.txt
  4. To run locally, execute this command. When you want to stop the server, press Ctrl + C.

    mkdocs serve
  5. From your browser, go to URL localhost:8000 to see the documentation page.