Able Alliance is a GT student organization that is dedicated to improving on-campus disability inclusion via access & resource sharing, community & social support, etc. This is a transporation management system built for them. Learn more about the organization at https://sites.gatech.edu/gtablealliance/.
A deployment preview of the main branch from netlify is available here. The websocket express js server is hosted seperately here.
The mock cas express js server is hosted seperately here
- Install Node.js 24
- Install MongoDB Community Server for a local MongoDB instance, or use MongoDB Compass to inspect the database.
- Install and enable Prettier in VS Code (optional but recommended).
- Ensure a MongoDB instance is running locally. For example:
docker run --name mongodb -d -p 27017:27017 mongo
- In the project root, run:
npm ci
- Create a
.envfile in the project root withMONGODB_URI. Copy from.env.example:Then setcp .env.example .env
MONGODB_URI=mongodb://localhost:27017/able-alliance(or your MongoDB connection string). - Start the Next.js dev server:
npm run dev
- Open http://localhost:3000/ in your browser.
- Install Docker.
- From the project root, start the app and MongoDB with Docker Compose:
The app service receives
docker compose up
MONGODB_URIfrom the Compose file (mongodb://mongo:27017/able-alliance?replicaSet=rs0). No extra env file is required for Docker. - To rebuild after changing dependencies, run:
docker compose down -vto delete the old containers and volumes and then rebuild withdocker compose up --build
Note: If you run Mongo via Docker Compose, avoid starting another MongoDB on localhost:27017; Compose will start Mongo inside the stack and expose it.
To seed the database with sample users, locations, vehicles, and routes, run:
npm run seed -- "mongodb://localhost:27017/able-alliance?replicaSet=rs0&directConnection=true"