Zenica Bus Tracking Application

This application is designed for tracking buses in the city of Zenica, Bosnia and Herzegovina.

Deployment: Zenica Bus Tracking

Project Design

• Figma Idea #1: View Project on Figma
• Figma Idea #2: View Project on Figma

Join our Community: ZeForge Discord server

---

Getting Started

Prerequisites

Make sure you have the following installed:

• Node.js: Download Node.js
• pnpm: Install pnpm

Installation

1. Install dependencies:

   pnpm install

2. Frontend Setup:

   • For local development, create a .env.local file in the frontend directory with the following:

     NEXT_PUBLIC_API_URL=http://localhost:3001
     

   • For production builds, create a .env.production file in the frontend directory:

     NEXT_PUBLIC_API_URL=https://production-server-url.com
     

3. Backend Setup:

   • In the /backend/ directory, create a .env file and add the following environment variables:

     SMTP_HOST=your-smtp-host                # e.g., smtp.gmail.com
     SMTP_PORT=your-smtp-port                # e.g., 587 for TLS or 465 for SSL
     [email protected]           # Your email address
     SMTP_PASS=your-app-password              # App password for the email account
     SENDER_EMAIL=your-sender-email           # Email address for outgoing emails
     [email protected] # Default recipient email address
     DEFAULT_RECEIVER_NAME=your-receiver-name     # Name of the default recipient
     

   • Replace placeholders with your actual values. Note: If using Gmail, you may need to enable "Less secure app access" or use an App Password to authenticate.

4. Run the Application:

   Run both the frontend and backend together:

   pnpm turbo dev

Accessing the Application

After setting up and running the application, you can access it at:

http://localhost:3000