Ashes of War

Table of Contents

• Project Goals
• Tech Stack
• Local Development
• Quality Checks
• Architecture Notes

Ashes of War is a frontend-only companion application for a World War II tabletop wargame system. It provides a searchable rules reference, a curated catalogue of historical units and weapons, and an army builder for composing force lists directly in the browser.

The application is deployed at https://aow.labcabrera.com/.

Project Goals

The project is designed as a lightweight, self-contained tool for players who need quick access to game data during list building and play. It does not require a backend, user accounts, or external APIs. All user-created army data is stored locally in the browser.

Core capabilities include:

• Browse unit profiles, movement, armour, thresholds, weapons, and descriptions.

• Browse weapon profiles and see which units carry each weapon.

• Build and persist army lists using browser local storage.

• Use the application in English or Spanish.

• Deploy as a static single-page application.

Tech Stack

• React 18

• TypeScript

• Vite

• Material UI

• React Router

• react-i18next

• Vitest

Local Development

Install dependencies:

npm install

Start the development server:

npm run dev

The local application is served by Vite, usually at:

http://localhost:5173

Quality Checks

Run the test suite:

npm run test:run

Run ESLint:

npm run lint

Build the production bundle:

npm run build

Architecture Notes

Ashes of War is intentionally frontend-only. Static game data lives in JSON files under src/data, domain types live under src/types, and route-level views live under src/pages.

The army builder persists user-created lists through browser local storage, keeping the application deployable as static assets without server infrastructure.