utopianf / mapkicker

mapkicker

Environment setup

You need to have Go, Node.js, Docker, and Docker Compose (comes pre-installed with Docker on Mac and Windows) installed on your computer.

Verify the tools by running the following commands:

go version
npm --version
docker --version
docker-compose --version

Start in development mode

In the project directory run the command (you might need to prepend it with sudo depending on your setup):

docker-compose -f docker-compose-dev.yml up

This starts a local MySQL database on localhost:3306. The database will be populated with test records from the init-db.sql file.

Navigate to the server folder and start the back end:

cd server
go run server.go

The back end will serve on http://localhost:8080.

Navigate to the webapp folder, install dependencies, and start the front end development server by running:

cd webapp
npm install
npm start

The application will be available on http://localhost:3000.

Start in production mode

Perform:

docker-compose up

This will build the application and start it together with its database. Access the application on http://localhost:8080.