Mancala Game

Yet Another Mancala Game Implementation

About

This application simply implements 6-stone version of Mancala Game. Players can play this game via web based user interface. Please see WikiPedia page for more information about the game.

Demo

Application is hosted on DigitalOcean Ubuntu droplet. You can access the demo app via the link below:

Mancala Game Demo

How to play

After clicking 'Start Game', whenever another user is connected, your turn sign will be changed to YES. Then, you can right click any of your pits and click 'Play' button to make a move.

Technology Stack

Component	Technology
Frontend	Angular 4, PrimeNG, OpenLayers
Backend	Spring Boot
Security	Not Implemented
Persistence	H2 in-memory database
Client Build Tools	angular-cli, npm
Server Runtime	Nginx

Missing Features

• Websocket Communication (this application simply use client side polling)
• Persistent Database (data is not persisted in this version)
• Authentication/Authorization (not implemented)
• Documentation (Architecture, API ...)

How to build & run

Server should have installed Java 8+, Maven 3.5+ and Node.js 9+ runtime environment.

Project has Maven based modular structure. In order to build project, under "code" folder simply run:

# Navigate to PROJECT_FOLDER/code (should contain pom.xml) and then
mvn clean package

This command will simply build both backend and frontend project, run unit tests and create executable jar binary. Then navigate to backend folder and run:

# Navigate to PROJECT_FOLDER/code/mancala-backend/target and then
java -jar mancala-backend-1.0-SNAPSHOT.jar

Then open your web browser and type:

http://localhost:8080

That's it !