Chronicle

---

[!IMPORTANT] The Chronicle license permits non-commercial hosting, subject to the Self Hosted Requirements. Every hosted deployment must retain the required Chronicle branding, the linked Powered by Chronicle footer mark, and the support banner. Read the Self Hosted Requirements before operating a copy.

Chronicle transforms raid logs into a live, interactive breakdown of everything that happened in your raid.

Features

🎬 Live Playback — Replay logs in real time with animated meters. Link a YouTube video and it syncs automatically — switch fights and the video seeks to match.

🔍 Custom Filters — Filter any panel by ability, school, hit type, source, target, and more. See it in action →

🔗 Shareable Links — Every view is URL-encoded — encounters, filters, layout, time range. Copy the link and anyone sees exactly what you see.

📐 Customizable Layouts — Resize, rearrange, and swap panels. Save layouts and share them with your guild.

⏱️ Time Range Selection — Drag-select on the timeline to filter every panel to that slice.

🎒 Loot & Gear — See what dropped and inspect player gear from the log.

⚔️ Class-Specific Panels — Sunder Armor uptime, debuff tracking, and more.

---

Development

Full Docker Stack

# Optional: copy defaults before customizing
cp .env.example .env

# Build and start Chronicle, Postgres, SpiceDB, and OCR
docker compose up --build

The app will be available at http://localhost:4000.

The supporting services stay on the Docker network by default so the stack does not collide with local Postgres, SpiceDB, or OCR processes you may already have running.

To build a different embedded server dataset, override SERVER, for example SERVER=azerothcore docker compose up --build.

Local Hybrid Development

# Start local dependencies first (Postgres on :5433, SpiceDB, OCR)
make services-up

# Full dev server: backend on :4000 with built frontend assets served by Go
make develop

# Backend only: no embedded dist build required, uses slim frontend assets
make develop-backend

# Frontend with hot reload (proxies to backend on :4000)
cd frontend/chronicle
pnpm install
pnpm dev

# Optional: create the chronicle database when using a local Postgres client
make create-db

Tech Stack

Layer	Technology
Backend	Go
Frontend	React + TypeScript + Vite + Tailwind CSS
Database	PostgreSQL
Auth	OAuth (Discord)