Skip to main content

Welcome to Trackmart

Build powerful ordering and delivery experiences with real-time tracking, Firebase authentication, and Mapbox integration.

Get StartedExplore Features
Real-time tracking
Live location updates
Secure authentication
Firebase Auth integration
In-app messaging
Driver-customer chat

Quick start

Get up and running with Trackmart in minutes

1

Install dependencies

Clone the repository and install Flutter dependencies:
git clone https://github.com/MichaelTendoSsemwanga/trackmart.git
cd trackmart
flutter pub get
2

Configure Firebase

Set up Firebase for authentication and real-time database:
  • Create a Firebase project at console.firebase.google.com
  • Download google-services.json for Android and GoogleService-Info.plist for iOS
  • Enable Firebase Authentication (Phone and Email)
  • Enable Realtime Database and Cloud Firestore
See the Firebase setup guide for detailed instructions.
3

Add Mapbox API key

Configure Mapbox for real-time tracking and route visualization:
// In lib/map.dart, replace the access token
'https://api.mapbox.com/directions/v5/mapbox/driving/...?access_token=YOUR_MAPBOX_TOKEN'
Get your API key from mapbox.com.
4

Run the app

Launch the app on your device or emulator:
flutter run
You can now authenticate, place orders, and track deliveries in real-time.

Explore by topic

Everything you need to build with Trackmart

Ordering system

Create and manage orders with product selection, quantity, and pricing

Real-time tracking

Track driver locations with live updates using Mapbox and Firebase

Delivery management

Handle delivery workflows from dispatch to completion

Messaging

Enable communication between customers and drivers via in-app chat

User guides

Learn how to use Trackmart effectively

Authentication

Phone and email authentication setup

Placing orders

Step-by-step order placement guide

Tracking deliveries

Monitor deliveries in real-time

Payment methods

Configure mobile money and cash payments

Driver communication

Chat with drivers during delivery

Settings

Manage your account preferences

Development resources

Extend and customize Trackmart for your needs

Installation

Set up your development environment

Architecture

Understand the app structure and data flow

Theming

Customize colors and UI components

Testing

Run tests with Flutter Driver and Gherkin

Ready to get started?

Follow our quickstart guide to build your first ordering and tracking app with Trackmart

Start Building

Build docs developers (and LLMs) love

Get started for freeTalk to us