Atlanta Food Consortium

This project is developed by students at Georgia Tech in the Computing for Good Program.

Getting Started - Running Locally

Follow these steps to set up and run the Atlanta Food Consortium application on your local machine.

Prerequisites

Before you begin, ensure you have the following installed:

1. Node.js (v20.0.0 or higher)

   • Download from nodejs.org
   • Verify installation: node -v

2. Docker Desktop

   • Download from docker.com
   • Ensure Docker is running before proceeding

Installation Steps

1. Install Dependencies

   npm install

2. Start Docker Database

   docker compose up -d

   This will start a PostgreSQL database container on port 5434.

3. Run Database Migrations

   npm run migrate:dev

   This applies all Prisma migrations to set up your database schema.

4. Open Prisma Studio (Optional - in a separate terminal)

   npx prisma studio

   This opens a browser-based database GUI at http://localhost:5555

5. Start Development Server (in a separate terminal)

   npm run dev

   The application will be available at http://localhost:3000

Environment Variables

The project requires a .env file in the root directory. Key variables include:

DATABASE_URL="postgresql://atlanta_food_user:dev_password_change_in_production@localhost:5434/atlanta_food_consortium?schema=public"
NEXTAUTH_SECRET=your-secret-key-here
NEXTAUTH_URL=http://localhost:3000

Note: Docker Compose also loads the .env file and uses DATABASE_USER, DATABASE_PW, and DATABASE_NAME to configure the PostgreSQL container. You can either:

• Hard-code these values directly in docker-compose.yml, or
• Add them to your .env file so they're shared between Docker and your application

The DATABASE_URL in your .env file should match the credentials set in Docker Compose to ensure your application can connect to the database.

Stopping the Application

To stop the Docker database:

docker compose down

Contributors

The Atlanta Food Consortium application has been developed by:

• Abhishek Karkar
• Akram Alsamarae
• Akrem Elfatih Abdelwahab
• Jun Siang Neo
• Justin McLellan
• Mika Yoshimura
• Mitchell Rysavy
• Taisiia Bahbouche