Environment Setup

0. Clone the repository

   git clone ssh://git@codeberg.org/borisnl/Convinator.git convinator && \
   cd convinator
   

1. Install dependencies using pnpm

   pnpm install --frozen-lockfile
   

2. Copy the .env.example file to .env and set the CONVI_JWT_SECRET to a random string

   cp .env.example .env && \
   sed -i "s/^CONVI_JWT_SECRET=.*$/CONVI_JWT_SECRET=$(openssl rand -hex 32)/g" .env
   

3. Start the development containers:

   docker compose up -d
   

4. Setup garage (local S3 service). This command should also update your .env file with the generated secrets.

   ./scripts/setup-garage.sh
   

5. Run the backend using cargo

   cargo run
   

6. Run the frontend (in a new terminal)

   cd packages/convi-web && pnpm start
   

You should now be able to reach the frontend at localhost:4200 and start making changes!