dnd-hub/README.md

DnD Campaign Hub

Self-hosted web application and Discord bot for managing rotating DnD campaigns.

Stack

• Node.js + TypeScript (Express API + Discord bot + scheduler)
• React + Vite + TypeScript
• SQLite
• Docker Compose

Quick Start

1. Copy .env.example to .env and fill values.
2. Install dependencies:
   • npm install
3. Run DB migrations:
   • npm run migrate -w @dnd-hub/server
4. Run in dev mode:
   • npm run dev

Docker

1. Copy .env.example to .env.
2. Start:
   • docker compose up --build

Project Layout

• apps/server: API, SQLite access, scheduler, Discord bot and slash commands
• apps/web: React UI
• infra: Docker and nginx config

Transcript Session Feature

Added structured transcript support with campaign + character context.

Discord Commands

• /session start: starts a transcript session on the currently selected campaign
• /session stop: ends active transcript session
• /session status: shows active transcript session state

API Endpoints

• POST /sessions/start
• POST /sessions/:id/stop
• GET /sessions/active
• POST /sessions/:id/segments
• GET /sessions/:id/transcript
• POST /sessions/:id/push-to-cloud

Cloud Sync

If CLOUD_API_BASE_URL is configured, each transcript segment is queued and POSTed to:

• POST {CLOUD_API_BASE_URL}/transcripts/segments

Headers sent:

• X-API-Key: CLOUD_API_KEY
• X-Idempotency-Key: ${sessionId}:${sequence}
• X-Signature: HMAC-SHA256 payload signature using CLOUD_API_HMAC_SECRET