jhalitaksoy/mancala
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
560 Commits 4 Branches 0 Tags 3.4 MiB
TypeScript 47.3%
Java 45.3%
CSS 5.6%
JavaScript 0.7%
Dockerfile 0.3%
Other 0.7%
79f68416ee
Go to file
Halit Aksoy 79f68416ee feat(frontend): show the series above the game 
From the second game of a series, a strip shows the series score and a
box per game in the winner's colour, with the stores, who moved first
and how it ended; a finished game opens its replay in a new tab. The
game over card shows the series score too. Spectators see names.
2026-10-17 02:15:53 +03:00
apps feat(frontend): show the series above the game 2026-10-17 02:15:53 +03:00
config feat(keycloak): add Keycloak with guest login extension 2026-10-14 01:46:48 +03:00
docs/specs feat(frontend): show the series above the game 2026-10-17 02:15:53 +03:00
packages feat(core): add rematch channels, series types and texts 2026-10-17 02:05:12 +03:00
.dockerignore feat(backend): replace the Node backend with the Quarkus backend 2026-10-16 11:47:40 +03:00
AGENTS.md fix(frontend): animate the lesson moves 2026-10-16 16:05:39 +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 docs: describe the Java backend 2026-10-16 11:53:13 +03:00
TODO.md docs(todo): correct the web app's known type errors 2026-10-16 16:24:49 +03:00

README.md

Mancala

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

Development

The web and mobile 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 the backend (Java 25 and Quarkus, see apps/backend/README.md) and the web app:

cd apps/backend && ./mvnw quarkus:dev     # port 5005
cd apps/frontend && yarn dev              # 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 .