https://github.com/fdifrison/catan-dice-counter
https://github.com/fdifrison/catan-dice-counter
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/fdifrison/catan-dice-counter
- Owner: fdifrison
- Created: 2025-03-01T14:32:52.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-05T09:48:38.000Z (over 1 year ago)
- Last Synced: 2025-12-31T10:09:39.646Z (6 months ago)
- Language: TypeScript
- Size: 4.77 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Catan Dice Counter
Catan Dice Counter is a full-stack web application designed to enhance the Catan board game experience by tracking dice
rolls, turns, game durations, and player statistics. Built with Angular 19 for the frontend and Spring Boot 3.4.3 with
Java 23 for the backend, it uses SQLite for lightweight data persistence and provides a polished, thematic user
interface.
## Features
- **Game Setup**: Create games with 2-5 players, assign unique colors, and set player order with drag-and-drop
functionality.
- **Gameplay Tracking**: Record dice rolls and turn durations in real-time, with a stacked bar chart visualizing roll
distributions.
- **End Game**: Assign ranks and points to players, with a victory modal featuring confetti effects.
- **History**: View past games, delete them, and access detailed game statistics with charts (roll distribution, roll
sequence, time management).
- **Player Statistics**: Analyze individual player performance across all games, including total points, average points,
lucky number, roll distribution, and turn time analysis.
- **Error Handling**: User-friendly modals for errors, such as attempting to end a turn without selecting a dice number.
- **Thematic Design**: Consistent use of the `Cinzel` font, gold (`#d4af37`) accents, and a red gradient theme inspired
by Catan.
## Tech Stack
### Frontend
- **Framework**: Angular 19
- **Libraries**: Chart.js (visualizations), Angular CDK (drag-drop), Canvas Confetti (effects)
- **Styling**: Custom CSS with a Catan-inspired theme
- **Build Tool**: Angular CLI
### Backend
- **Framework**: Spring Boot 3.4.3 with Java 23
- **Database**: SQLite with HikariCP connection pooling
- **ORM**: JPA/Hibernate with SQLite dialect
- **Schema Management**: Liquibase
- **DTO Mapping**: MapStruct
- **Logging**: SLF4J
### Deployment
- **Containerization**: Docker with a multi-stage build
- **Hosting**: Deployed on Railway (or adaptable to other platforms)
## Prerequisites
- **Node.js**: v20.11.0 or later
- **npm**: v10.2.4 or later
- **Java**: JDK 23
- **Maven**: 3.9.6 (included in Docker build)
- **Docker**: Optional, for containerized deployment
## Setup Instructions
### Local Development
1. **Clone the Repository**:
```bash
git clone
cd catan-dice-counter
```
2. **Fronted Setup**
```bash
cd frontend
npm install
ng serve
```
## Docker deployment
```bash
docker build -t catan-dice-counter .
docker run -p 8080:8080 -v $(pwd)/data:/app/data catan-dice-counter
```
## Environmental variables
* **PORT**: Override default port (8080).
* **DATASOURCE_URL**: Custom SQLite path (e.g., jdbc:sqlite:/custom/path/database.db).