mancala

Go to file

Halit Aksoy f0ffd6ba87 feat(backend): add the Quarkus project with a Java port of the engine Quarkus 3.40 on Java 25, built with the Maven wrapper. The engine is a line-by-line port of packages/mancala.js; a parity test replays games recorded with the TypeScript engine, including illegal moves, and compares every board, turn, error and the game JSON.		2026-10-16 11:06:43 +03:00
apps	feat(backend): add the Quarkus project with a Java port of the engine	2026-10-16 11:06:43 +03:00
config	feat(keycloak): add Keycloak with guest login extension	2026-10-14 01:46:48 +03:00
docs/specs	feat(backend): add the Quarkus project with a Java port of the engine	2026-10-16 11:06:43 +03:00
packages	fix(core): empty the first pit when animating a single stone move	2026-10-16 10:49:09 +03:00
.dockerignore	build: use local mancala.js and @mancala/core packages	2026-10-14 02:09:05 +03:00
AGENTS.md	Merge branch 'feature/keycloak-theme' into develop	2026-10-16 10:38:12 +03:00
CLAUDE.md	docs: add AGENTS.md with setup, checks and pitfalls, and CLAUDE.md pointing to it	2026-10-16 00:44:09 +03:00
package.json	build: use local mancala.js and @mancala/core packages	2026-10-14 02:09:05 +03:00
README.md	build: add shared Postgres and Valkey to compose	2026-10-16 00:05:21 +03:00
TODO.md	docs: add publishing mancala.js to the TODO	2026-10-16 10:52:15 +03:00

README.md

Mancala

Mancala is an open source application for playing mancala game online.

Development

The apps use the local packages/mancala.js and packages/core through link: dependencies, so build those first:

yarn build:packages        # from the repo root

After changing a package, rebuild it (or run yarn dev in it to rebuild on change); the apps pick up the new dist.

Postgres (games and Keycloak), Valkey (live games and caches) and Keycloak run with Docker Compose. Create apps/.env once, then start them:

cd apps
cat > .env <<EOF
POSTGRES_PASSWORD=postgres
KEYCLOAK_DB_PASSWORD=keycloak
KEYCLOAK_ADMIN_PASSWORD=admin
MANCALA_DB_PASSWORD=mancala
EOF
docker compose up -d --build postgres valkey keycloak

Postgres is on localhost:5433 and Valkey on localhost:6379; the backend's defaults point there. Then run yarn dev in apps/backend (port 5005) and in apps/frontend (port 1234).

Docker images for the backend and frontend are built from the repo root:

docker build -f apps/backend/Dockerfile -t jhalitaksoy/mancala-backend .
docker build -f apps/frontend/Dockerfile -t jhalitaksoy/mancala-frontend .