Polyominoes
A repository to for a web application game I made for CS-389: Advanced Software Engineering.
This project is a webapp that lets users play a game that is similar to Tetris, but has polyominoes from monomino to hexominoes. Users can play without an account, but if they create an account the application will track their high scores. The high scores can be viewed on the leaderboard page to see who is the top player.
You are welcome to download/clone the project build and set up you own database.
-
For easy deployment you can use docker and docker compose:
- Instructions to install docker can be found here: https://docs.docker.com/get-docker/
- Instructions to install docker compose plugin can be found here: https://docs.docker.com/compose/install/
-
Once you have docker and docker compose install you can download the DockerDeployment.zip from the latest release.
-
Unzip the file and navigate through the terminal to the Polyominoes directory.
-
Run the command
docker-compose up -dto launch the application -
The application can be accessed at https://localhost:8080/
To build the project I recommend using docker to launch the postgresql database.
-
Install Docker
- Instructions to install docker can be found here: https://docs.docker.com/get-docker/
-
Once docker has been downloaded, open up the command line interface of your choice, type the following:
docker pull postgres -
Execute the following command to set up your database container:
docker run --name <container-name> -e POSTGRES_USER=polyominoes -e POSTGRES_PASSWORD=appPassword -e POSTGRES_DB=polyominoes -p 5432:5432 -d postgres -
Now that your database is running you can use git to clone the repository or download the src from the latest release
-
Navigate to the application directory in your terminal and run the command
./gradlew build- Note Java 17 is need to run gradle and build the application
-
Once build is complete run the command
./gradlew bootRun