setup.md

Local Development Setup

This guide covers how to set up Solid Fortnight for local development.

1. Prerequisites

Ensure you have the following installed:

• Go: Version 1.25.0 or higher.
• Docker & Docker Compose: For running infrastructure (PostgreSQL and Redis).
• Bun: For dashboard development.
• Bruno: For testing the APIs.

2. Initial Setup

1. Clone the Repository:

   git clone https://github.com/adafia/solid-fortnight.git
   cd solid-fortnight

2. Environment Variables: Copy the example environment file and load it:

   cp .env.example .env
   source ./scripts/env.sh load

3. Start Infrastructure:

   Spin up the PostgreSQL and Redis containers:

   make db-up

3. Running Services

You can run the unified server and dashboard locally:

Service	Command	Port
Unified Server	make run-server	8080
Dashboard	make run-ui	5173

Running everything in Docker

To run the entire optimized stack (Unified Server + Infrastructure + UI) in Docker:

make start-all

4. Useful Commands

• Run all backend tests: make test
• Run dashboard unit tests: make test-ui
• Run E2E tests: make test-e2e
• Clean Docker: make clean

5. API Testing

We use Bruno for API exploration.

1. Open Bruno.
2. Import the collection from the bruno/ directory.
3. Select the Local environment.