Skip to content

Prerequisites

This project uses Devbox to manage the development environment. Devbox provides a consistent, isolated environment with all the necessary CLI tools pre-installed.

Docker

The rest of the tools are already installed in the devbox environment

Devbox

Clone the Repository

git clone https://github.com/your-username/your-repo.git
cd your-repo

Start the Devbox Environment and poetry environment

devbox shell # Start the devbox environment (this will also start the poetry environment)
poetry install # Install dependencies
poetry env activate # use the output to activate the poetry environment ( ONLY IF DEVBOX DOES NOT ACTIVATE THE ENVIRONMENT)
mkdocs serve # Start the mkdocs server http://127.0.0.1:8000/your-repo/

Note

The first time you run devbox shell, it will take a few minutes to install the necessary tools. But after that it will be much faster.