The flag-guessing game.
A simple guessing game where you are presented with pieces of an image. The image is of a flag, and you need to guess which country the flag belongs to. If you do not know, you can reveal the next piece of the flag, or you can skip it.
Click to see screenshots!
You will need to start by cloning this repo:
git clone https://github.com/devklick/flaggle.git
Then install the package:
npm i
A postgres database is required to run the game, and the most convenient way to get started is to use docker to run a container with postgres installed. For example:
docker run --name flaggle-postgres -p 5432:5432 -e POSTGRES_PASSWORD=postgres -d postgres
(See the official docs for more on this.)
Once you have the container running, you will need to create a database called flaggle. Connect to the postgres server with client of your choice and run the create database script:
CREATE DATABASE flaggle;If you used a different username, password or post when running your postgres container, you will need update the env file the correct values. Otherwise if you used the ones mentioned here, you can skip this step.
Next, the database schema needs to be deployed. We can do this with the prisma cli as follows, which will update to the latest migration):
npx prisma db push
Now that we have the database schema ready, we need to seed the data required by the game. Again, we use the prisma CLI to do this:
npx prisma db seed
Ths process may take a minute or so, as the seed process has to pull down country data from restcountries, download the flag images, split them up into chunks, and save the chunks to your local file system.
(Note, sometimes the prisma CLI does not close properly, co you may need to hit Ctrl + c to exit out of it.)
Now we're ready to run the application. To do so, we can simply run:
npm start
This will go off and run the API and UI in parallel.