gomolemontlhane/komba_app

Komba is a ride-hailing application designed to connect users with nearby drivers in real time. This MVP (Minimum Viable Product) focuses on delivering essential functionality, allowing users to search routes, receive fare estimates, and access real-time traffic information. # Komba - Your Smart South African Taxi Navigator ## Introduction Komba is a mobile application designed to enhance the navigation experience within South Africa's minibus taxi system. It provides real-time predictions of pick-up and departure times, suggests the nearest taxi ranks, and helps users discover points of interest along their routes. The app aims to simplify public transportation for both locals and tourists, promoting responsible tourism and supporting local businesses. ## Deployment You can access the deployed version of the application here: Komba App ## Blog Article Read more about the development and features of Komba in our blog post: Komba Development Blog ## Author(s) - Gomolemo Ntlhane ## Installation To set up the project locally, follow these steps: 1. **Clone the repository**: ```bash git clone github.com ``` 2. **Navigate to the project directory**: ```bash cd koma_app ``` 3. **Install the required packages: Make sure you have Python and pip installed, then run:** ```bash pip install -r requirements.txt ``` 4. **Run the applicatoin: Start the Flask server with the command** ```bash flask run ``` ## Project Structure ```graphql komba_app/ │ ├── app.py # Main application file ├── background.jpg # Background image ├── komba_bg.jpg # Additional background image ├── lock_FILL1_wght400_GRAD0_opsz24.svg # SVG icon for lock ├── person_FILL1_wght400_GRAD0_opsz24.svg # SVG icon for person ├── models/ # Directory for data models │ └── models.py # Data models ├── static/ # Directory for static files │ ├── images/ # Directory for images │ ├── scripts.js # JavaScript functionalities │ └── style.css # CSS styles └── templates/ # Directory for HTML templates ├── home.html # Home page ├── login.html # Login page ├── signup.html # …