The project arterfacts that are utilised to build the project are found in 2 main folders:
- parklink-microservices - This folder contains the microservices that are used to build the backend services using docker orchestration.
- parklink-frontend - This folder contains the frontend of the project that is ran using node
- Docker - https://www.docker.com/products/docker-desktop/
- Node - https://nodejs.org/en/download
- NPM - https://docs.npmjs.com/downloading-and-installing-node-js-and-npm
- Open your terminal
- Run the command
docker -v
to check if you have docker installed - Run the command
node -v
to check if you have node installed
- Clone the repository
- Navigate to the parklink-microservices folder
- Run the command
docker-compose up --build -d
- Navigate to the parklink-frontend folder
- Run the command
npm install
- Run the command
npm run dev
- Open your browser and navigate to
http://localhost:3000
The docker container will build all the essential services required to run the project. The frontend will be running on port 3000. All the license keys etc that are required to run some of the plugins that require PRO versions are included and populated automatically within the docker container e.g. Hangfire Pro or LocalStack PRO.
Some of the services such as Parklink API, and Booking API have support to switch between the development and production environment. The development environment is used to run emulate AWS services using localstack locally on the host machine. The production environment is used to send content to the official AWS services.
To build the project locally you will need to have the following installed:
- .NET Core SDK - https://dotnet.microsoft.com/en-us/download (the most recent version is 8 but the SDK should work with 7 just fine)
- Rider - https://www.jetbrains.com/rider/download/ (recommended)
- Mapbox API
- SendGrid
- LocalStack (required for local development instances e.g. "Development" variable)
- Hangfire Pro
- AWS S3 (required for production environments)