Konabra is a smart, community-powered transport and road safety platform designed for Ghana and similar regions. The name is derived from the Twi phrase “ko na bra”, meaning “go and come” — a culturally rich expression symbolizing movement, action, and return.

Konabra reflects the everyday journeys of Ghanaians and serves as a call to actively participate in making our roads safer and more efficient.

Konabra is a mobile and web platform that empowers drivers, passengers, and pedestrians to:

• 📍 Report live road incidents — accidents, police barriers, traffic jams, potholes, broken streetlights, and more
• 🗺️ View current road conditions through an intuitive map interface
• 🛠️ Get real-time alerts about incidents and congestion on their routes
• 📊 Help authorities analyze trends, hotspots, and response effectiveness through smart dashboards

To revolutionize road safety and traffic management in Ghana by connecting people, data, and authorities — one report at a time.

• cmd/api/: Main Go backend API (main.go)
• apps/next/: Next.js frontend for the web platform
• apps/nuxt/: Nuxt.js frontend (optional, for alternative frontend implementations)
• internal/: Shared Go packages (e.g., builds, constants, handlers, helpers, models, probes, repos, services)
• logs/: Log files for the application
• pkg/: External Go packages
• scripts/: Utility scripts for development and deployment
• utils/: Miscellaneous utilities

• Go: Version 1.18 or later
• Node.js: Version 18.x or later
• PostgreSQL: For the database (inferred from pkg folder, adjust if using a different DB)
• Git: To clone the repository

1. Clone the repository:

   git clone https://github.com/prince272/konabra.git
   cd konabra

2. Set up environment variables:

   • Rename the .env.local file .env to create a .env file:
   • Edit .env to configure your database credentials, API keys, and other settings.

3. Install backend dependencies:

   go mod tidy

4. Install frontend dependencies (Next.js):

   cd apps/next
   npm install

5. Run the backend:

   go run cmd/api/main.go

   The API will typically run on http://localhost:8080 (check your .env or code for the exact port).

6. Run the frontend:

   cd apps/next
   npm run dev

   The Next.js app will run on http://localhost:3000 by default.

7. Access the app: Open your browser and navigate to http://localhost:3000 to explore Konabra.

This project is licensed under the MIT License. See the LICENSE file for details.

Let’s work together to make roads safer for everyone! 🚗