SmartRoute Planner 🚗📍

A production-ready Flutter mobile application for interactive SmartRoute planning with real-time routing, distance calculation, location services, and an intuitive map interface.

Feature	Screenshot	Description
🎯 Welcome Screen		Beautiful onboarding with instructions
🗺️ Interactive Map		OpenStreetMap with tap-to-select
🛣️ Route Display		Real-time route with distance & time
📍 Location Services		Smart permission handling

✨ Features Core Features

• ✅ Interactive Map Interface - Pan, zoom, and tap to select points
• ✅ Point-and-Select Functionality - Easy origin and destination marking with visual feedback
• ✅ Real-time Route Display - Instant route calculation using OSRM (Open Source Routing Machine)
• ✅ Distance & Duration - Accurate distance calculation and estimated travel time
• ✅ Current Location - GPS-based location services with permission handling
• ✅ Route Information Card - Displays distance, duration, and average speed

Advanced Features

• 🎯 Smart Location Services - Automatic location fetch on app start
• 🔄 Swap Origin/Destination - Easily reverse your route
• 📍 Visual Markers - Clear green (start) and red (end) markers
• 🗺️ Route Visualization - Beautiful blue polyline with smooth rendering
• 💫 Animated Instructions - Step-by-step guidance with progress indicators
• 🎨 Material Design 3 - Modern, beautiful UI/UX
• 🌍 OpenStreetMap Integration - Free, open-source map tiles

Technical Features

• 🏗️ Clean Architecture - Separation of concerns with feature-first structure
• 🔥 BLoC State Management - Reactive, predictable state management
• 🧪 Production-Level Code - Comprehensive error handling, logging, and testing
• 🌈 Flutter Flavors - Development and Production environments
• 📦 Dependency Injection - GetIt for clean dependency management
• 🔒 Type Safety - Freezed models with code generation

🏛️ Architecture

This project follows Clean Architecture principles with a feature-first folder structure:

lib/
├── main.dart
├── main_development.dart          # Development flavor entry
├── main_production.dart            # Production flavor entry
│
├── app/                            # Application layer
│   ├── app.dart                    # Main app widget
│   ├── router/                     # Navigation/routing
│   │   └── app_router.dart
│   └── theme/                      # Theme configuration
│       └── app_theme.dart
│
├── core/                           # Core utilities
│   ├── config/                     # App configuration
│   │   └── flavor_config.dart
│   ├── constants/                  # Constants
│   │   ├── api_constants.dart
│   │   └── app_constants.dart
│   ├── di/                         # Dependency injection
│   │   └── injection_container.dart
│   ├── errors/                     # Error handling
│   │   ├── exceptions.dart
│   │   └── failures.dart
│   ├── network/                    # Network layer
│   │   ├── dio_client.dart
│   │   └── network_info.dart
│   ├── utils/                      # Utilities
│   │   ├── extensions.dart
│   │   └── logger.dart
│   └── widgets/                    # Reusable widgets
│       ├── error_widget.dart
│       ├── loading_widget.dart
│       ├── permission_dialog.dart
│       └── welcome_dialog.dart
│
└── features/                       # Features
    └── map/                        # Map feature
        ├── data/                   # Data layer
        │   ├── datasources/
        │   │   ├── routing_remote_datasource.dart
        │   │   └── routing_remote_datasource_impl.dart
        │   ├── models/
        │   │   ├── coordinate_model.dart
        │   │   ├── route_model.dart
        │   │   └── route_response_model.dart
        │   └── repositories/
        │       └── route_repository_impl.dart
        │
        ├── domain/                 # Domain layer (Business Logic)
        │   ├── entities/
        │   │   ├── coordinate.dart
        │   │   ├── route.dart
        │   │   └── route_info.dart
        │   ├── repositories/
        │   │   └── route_repository.dart
        │   └── usecases/
        │       ├── calculate_distance.dart
        │       └── get_route.dart
        │
        └── presentation/           # Presentation layer (UI)
            ├── bloc/
            │   ├── map_bloc.dart
            │   ├── map_event.dart
            │   └── map_state.dart
            ├── screens/
            │   └── map_screen.dart
            └── widgets/
                ├── location_marker.dart
                ├── map_widget.dart
                ├── route_info_card.dart
                └── route_polyline.dart

🛠️ Tech Stack

Framework & Language

• Flutter 3.0+ - Cross-platform mobile framework
• Dart 3.0+ - Programming language

State Management

• flutter_bloc ^8.1.5 - BLoC pattern implementation
• bloc ^8.1.4 - Core BLoC library
• equatable ^2.0.5 - Value equality

Map & Location

• flutter_map ^6.1.0 - Interactive map widget
• latlong2 ^0.9.0 - Latitude/Longitude calculations
• location ^6.0.2 - Location services (GPS)
• OpenStreetMap - Free map tiles
• OSRM - Free routing API (No API key required!)

Networking

• dio ^5.4.0 - HTTP client
• retrofit ^4.0.3 - Type-safe REST client
• pretty_dio_logger ^1.3.1 - Request/response logging
• internet_connection_checker ^1.0.0+1 - Network connectivity

Code Generation

• freezed ^2.4.6 - Immutable models
• json_serializable ^6.7.1 - JSON serialization
• build_runner ^2.4.8 - Code generation runner

Dependency Injection

• get_it ^7.6.7 - Service locator
• injectable ^2.3.2 - Code generation for DI

Utilities

• dartz ^0.10.1 - Functional programming (Either)
• logger ^2.0.2 - Beautiful logging
• shared_preferences ^2.2.2 - Local storage
• flutter_flavor ^3.1.3 - Environment flavors

🚀 Getting Started

Prerequisites Ensure you have the following installed:

• Flutter SDK (>=3.0.0) - Install Flutter
• Dart SDK (>=3.0.0) - Comes with Flutter
• Android Studio / VS Code with Flutter extensions
• Android SDK / Xcode (for iOS)
• Git for version control

Installation

• Clone the repository``

git clone [https://github.com/majharul-islam181/SmartRoute.git]
cd smart_route

• Install dependencies flutter pub get

• Run code generation flutter pub run build_runner build --delete-conflicting-outputs

• Check Flutter setup flutter doctor -v

• 🎮 Running the App

Development Mode

# Run on connected device (without flavors)
flutter run

# Run with development flavor
flutter run --flavor development -t lib/main_development.dart

# Run on specific device
flutter run --flavor development -t lib/main_development.dart -d <device-id>

# List available devices
flutter devices

Production Mode

# Run production flavor
flutter run --flavor production -t lib/main_production.dart --release

📦 Building APK/IPA

# Debug APK (Development)
flutter build apk --flavor development -t lib/main_development.dart --debug

# Release APK (Production)
flutter build apk --flavor production -t lib/main_production.dart --release

# Split APKs by ABI (Smaller file size)
flutter build apk --flavor production -t lib/main_production.dart --release --split-per-abi

• APK Location: build/app/outputs/flutter-apk/

• Android App Bundle (for Play Store) flutter build appbundle --flavor production -t lib/main_production.dart --release

• AAB Location: build/app/outputs/bundle/productionRelease/

iOS IPA

# Build for iOS
flutter build ios --flavor production -t lib/main_production.dart --release

# Create IPA
flutter build ipa --flavor production -t lib/main_production.dart --release

🌈 Flavors

• Switching Between Flavors

# Development
flutter run --flavor development -t lib/main_development.dart

# Production
flutter run --flavor production -t lib/main_production.dart