Wildmile Management Portal

Requirements

• Node.js 20 or later (Prefer to use the latest LTS version)
• A MongoDB server (You can use a free tier at MongoDB Atlas

Getting Started

Option 1: Run it Locally without Docker

Step 1. Get the connection string of your MongoDB server

In the case of MongoDB Atlas, it should be a string like this:

mongodb+srv://<username>:<password>@my-project-abc123.mongodb.net/test?retryWrites=true&w=majority

For more details, follow this MongoDB Guide on how to connect to MongoDB.

Step 2. Set up environment variables

Copy the .env.local.example file in this directory to .env.local (which will be ignored by Git):

cd wildmile
cp .env.local.example .env.local

Then set each variable on .env.local:

• MONGODB_URI should be the MongoDB connection string you got from step 1.

Step 3. Run Next.js in development mode

npm install
npm run dev

# or

yarn install
yarn dev

Your app should be up and running on http://localhost:3000! If it doesn't work, post on GitHub discussions.

Option 2: Running it locally using docker

Install Docker Desktop

Once the docker engine is running at the root folder run docker compose up -d. That will bring up the Mongo Database locally and seed it with the files in the repo and then create a container to run the nextJS application. You can access the website at localhost:8080

To run commands on the node app, like installing new packages or something similar you can exec into the container by doing docker compose exec web bash, which will create a terminal window for the container. Note that actions in the container are ephemeral and will not persist on rebuild.