Smart Cargo is a Flutter-powered delivery service app that connects users and retailers with drivers for fast, reliable, and affordable parcel delivery. It features real-time tracking, multilingual support (Swahili & English), intelligent pricing based on distance, weight, and size, and a streamlined request flow for pickup and drop-off.
# Smart Cargo Mobile App
> [!IMPORTANT]
> **App Status**: The Smart Cargo app is currently in development and has not yet been deployed to public app stores.
Smart Cargo is a delivery service mobile application that connects retailers and individual users with drivers to provide fast, reliable, and cost-efficient delivery of goods and parcels. The app targets common logistics problems such as high delivery costs, long delays, and unreliable service.
---
## Table of Contents
- Features
- Screenshots
- Technology Stack
- Getting Started
- Request Flow & Pricing
- Multilingual Support
- User Accounts & Terms
- Contributing
- Team
- License
- Contact
---
## Features
- **Multilingual Support**: Language preference available for **Swahili** and **English**, implemented app-wide.
- **Real-Time Tracking**: Track deliveries using a unique order number.
- **Delivery Request Flow**:
- Specify pickup and destination locations.
- Describe parcel by category, fragility, size, weight, and value.
- Select transport option (Bike, Motorbike, Car, Van).
- **Smart Pricing**: Automatic recommendations and price calculation based on parcel attributes and distance.
- **User Account**: Profile management and integrated Terms & Conditions.
## Screenshots
| Home | Request Flow |
|:---:|:---:|
| | |
| **Request Flow (Details)** | **Account & Settings** |
| | |
## Technology Stack
| Category | Technology | Description |
|----------|------------|-------------|
| **Framework** | Flutter (Dart) | Cross-platform mobile development |
| **Backend** | Django | Backend services and API |
| **AI Services** | ChatGPT | Customer support prompts |
| **Design** | Lovable.ai | Design and marketing helpers |
| **Maps** | OpenStreetMap API | Address input and geocoding |
| **CI/CD** | TBD | GitHub Actions / Codemagic (Planned) |
## Getting Started
### Prerequisites
- **Flutter SDK** (stable channel)
- **VS Code** or **Android Studio** with Flutter extensions
- Android/iOS Emulator o …