https://github.com/vbetsch/seven-wonders
⚔️ Digital adaptation of the Duel edition board game
https://github.com/vbetsch/seven-wonders
ci clean-code ddd eslint jest prettier tdd typescript
Last synced: about 2 months ago
JSON representation
⚔️ Digital adaptation of the Duel edition board game
- Host: GitHub
- URL: https://github.com/vbetsch/seven-wonders
- Owner: vbetsch
- License: mit
- Created: 2025-11-08T21:30:29.000Z (8 months ago)
- Default Branch: develop
- Last Pushed: 2025-11-22T21:03:11.000Z (7 months ago)
- Last Synced: 2026-04-18T21:18:52.477Z (2 months ago)
- Topics: ci, clean-code, ddd, eslint, jest, prettier, tdd, typescript
- Language: TypeScript
- Homepage:
- Size: 192 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 26
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Seven Wonders Duel
⚔️ Digital adaptation of the board game
## 🎮 Overview
This project aims to recreate the **Seven Wonders Duel** board game as a fully playable digital experience.
The long-term goal is to provide a complete game engine, a bot you can challenge, and eventually an online multiplayer
mode.
This repository currently focuses on the **core logic of the game**.
## 🧩 About the Board Game
**Seven Wonders Duel** is a 2-player competitive strategy game where players develop their civilization across three
Ages.
Each Age uses a specific pyramid-like structure of cards, with some cards visible and others hidden until revealed.
During their turn, players:
1. Pick a visible card from the structure.
2. Choose one of the following actions:
- Construct the building by paying its resource cost
- Discard the card to gain coins
- Use the card to build one of their Wonders
Victory can be achieved in **three different ways**:
- **Scientific Victory** – collect 6 different scientific symbols
- **Military Victory** – push the conflict pawn to the opponent’s capital
- **Civil Victory** – have the highest victory points at the end of the third Age
The game combines drafting, resource management, chain reactions, wonders, military pressure, and scientific progress,
creating deep and varied strategic possibilities.
## 🧠 Project Purpose
The goal of this repository is to implement the **entire game engine** of Seven Wonders Duel, including:
- Game entities (cards, Wonders, resources, players…)
- Age setup and card pyramid generation
- Turn management and game state transitions
- Military and scientific progression
- Victory condition checks
- Rules validation and enforcement
- Deterministic, testable logic
---
## 🛠️ Tech Stack
- **Node.js v22.17.1 LTS**
- **TypeScript** (decorators enabled)
- **Tsyringe** (dependency injection)
- **Jest** (unit tests)
- **ESLint + Prettier** (quality and formatting)
- **ts-node** (development runtime)
- **tsc-alias** (path alias resolution)
## 🚀 Getting Started
### 1. Install dependencies
```bash
npm install
```
### 2. Start the project (development)
### Run the CLI interface
```bash
npm start
```
## 🧪 Running Tests
### Run tests with coverage
```bash
npm run test:cov
```
## 🧹 Linting & Formatting
### Run linter and formatter checks
```bash
npm run lint
```
## 🏗️ Building the Project
```bash
npm run build
```
## 🧼 Code Philosophy
This project is built with:
- Clean Code principles
- High-level maintainability
- Strong domain separation
- Clear and modular architecture
- Agile-inspired processes
**We aim to deliver the cleanest and most robust implementation possible.**
## 🤝 Contributing
We welcome anyone who wants to participate in improving the project!
Before contributing, please read the dedicated guide:
👉 **See [CONTRIBUTING.md](docs/CONTRIBUTING.md) for detailed contribution instructions.**
Feel free to open issues, propose improvements, or submit pull requests.
[© 2025 vbetsch — MIT License](LICENSE)