DraftDream Monorepo

DraftDream is a multi-stack platform for coaching operations with five main applications:

• API (api/): NestJS GraphQL backend (hexagonal architecture)
• Frontoffice (frontoffice/): coach/athlete web application
• Backoffice (backoffice/): administration console
• Showcase (showcase/): public marketing + support website
• Mobile (mobile/): mobile/PWA surface

The repository also contains Docker orchestration (docker-compose*.yml) and shared deployment helpers (Makefile, Makefile.old).

---

Prerequisites

• Docker + Docker Compose plugin
• GNU Make
• Node.js 20+ and npm (for local stack-by-stack runs)

---

Quick start (Docker)

1. Clone the repository.
2. Create your local .env from the provided template (never commit secrets):

cp .env.example .env

3. Add local host entries (see below).
4. Start the dev profile:

docker compose -f docker-compose.dev.yml up -d

5. Check running services:

docker compose ps

---

Local DNS configuration

Add these entries to your hosts file:

127.0.0.1 api.local.fo
127.0.0.1 front.local.fo
127.0.0.1 back.local.fo
127.0.0.1 showcase.local.fo
127.0.0.1 mobile.local.fo
127.0.0.1 io.local.fo

---

Service endpoints

• API: http://api.local.fo
• Frontoffice: http://front.local.fo
• Backoffice: http://back.local.fo
• Showcase: http://showcase.local.fo
• Object storage (MinIO): http://io.local.fo

---

Useful commands

Command	Purpose
make help	List available make targets
make build	Build all service images
make <service>	Build and save a single image (e.g. make api)
docker compose -f docker-compose.dev.yml up -d	Start local development services
docker compose -f docker-compose.dev.yml down	Stop development services
docker compose -f docker-compose.dev.yml logs -f	Tail development logs
docker compose --profile prod up -d	Start production profile locally
docker compose --profile prod down	Stop production profile
docker compose --profile prod logs -f	Tail production logs
docker compose ps	Check status and health
docker compose logs -f <service>	Inspect service logs

---

Stack-specific documentation

• API README
• Frontoffice README
• Backoffice README
• Showcase README

---

Production note

Deployment commands in this repository assume SSH access to the target host and correctly configured variables in Makefiles (PROD_HOST, REMOTE_ROOT, REMOTE_IMAGE_DIR).