Getting started
Clone the workspace, layout, install, and run locally.
Workspace layout
| Path | Role |
|---|---|
backend/ | Cargo workspace: sw-domain, sw-plugin, sw-server |
frontend/ | Bun + Next.js arena UI |
checkers/, lexi-wars/, ludo/, ludo-rush/ | Game crates |
docs/ | This documentation site |
backend/sw-vault/ | Clarity vault (sw-vault-v1) |
Clone
git clone https://github.com/Stacks-Wars/backend.git
git clone https://github.com/Stacks-Wars/frontend.git
git clone https://github.com/Stacks-Wars/checkers.git
# …other games / docs as neededInstall
Backend
cd backend
cp .env.example .env # fill required values
# Postgres + Redis required
cargo build -p sw-serverFrontend
cd frontend
cp env.example .env.local
bun installGame crate (example)
cd checkers
cargo buildRun locally
- Start Postgres and Redis.
cd backend && cargo run -p sw-server(runs migrations).cd frontend && bun dev→ http://localhost:3000- Optional:
docker composeinbackend/for Redis + server image.
See Environment variables and Local development.