Go to file
Halit Aksoy aa265f7e6c feat(frontend): show the moves of a live game and let players look back
- Move list under the board with player, pit and what happened (extra
  turn, capture, stones to the store, game over); collapsed on phones
- Selecting a move or using the arrow keys shows that position with a
  banner and Back to live; pits are locked meanwhile and the banner says
  when it is your turn
- Countdown while the opponent is offline on their turn
- on_game_end is handled, so games that end by timeout or inactivity end
  on the page with the reason
2026-10-16 00:31:43 +03:00
apps feat(frontend): show the moves of a live game and let players look back 2026-10-16 00:31:43 +03:00
config feat(keycloak): add Keycloak with guest login extension 2026-10-14 01:46:48 +03:00
docs/specs/game-history feat(frontend): show the moves of a live game and let players look back 2026-10-16 00:31:43 +03:00
packages feat(frontend): show ongoing, live, popular and recent games on the home page 2026-10-16 00:27:06 +03:00
.dockerignore build: use local mancala.js and @mancala/core packages 2026-10-14 02:09:05 +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 TODO with mobile login and open issues 2026-10-14 09:13:52 +03:00

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 .