Skip to content

uxjulia/catan-tracker

Repository files navigation

Settlers of Catan - Dice Roll Tracker

Netlify Status

Track dice rolls while playing Settlers of Catan

https://catan.uxj.io

I built this for my own personal use, but maybe you'll find it helpful as well!

ko-fi

Features

  • Roll tracker — bar chart showing the distribution of all rolls in the current game
  • Virtual dice roller — roll dice in-app or manually enter the result with the numpad
  • Player tracking — track up to 6 players by name, auto-advances turn order after each roll
  • Resource tile tracker — map your board's resource tiles to their roll numbers so you can see what was produced each roll
  • Roll log — full history of every roll in the game
  • Resource log — history of which resources were produced each roll
  • Undo — remove the last logged roll
  • Full-screen mode — expand the chart for easier viewing across the table
  • 12-sided die support — for the Game of Thrones expansion
  • PWA — installable as a standalone app on mobile and desktop

Keyboard Shortcuts

Key Action
Space Roll dice
29 Log that roll value
0 Log 10
1 or - Log 11
= Log 12
Z Undo last roll
F Toggle full-screen
N Start new game

Tech Stack

  • React 19 + TypeScript
  • Vite + Tailwind CSS v4
  • Chart.js
  • Deployed on Netlify

Development

Prerequisites

  • Yarn or NPM
  • Node >= 25

If using npm then swap out yarn with npm run:

Install dependencies

yarn install

Run local development version

yarn dev

Build production version

yarn build

Lint / Format

yarn lint

yarn format

About

Track dice rolls while playing Settlers of Catan

Topics

Resources

Stars

Watchers

Forks

Contributors