Mobile App Overview

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/ihfaz297/MND/llms.txt

Use this file to discover all available pages before exploring further.

​

Architecture

lib/
├── config/          # App configuration and API settings
├── models/          # Data models
├── providers/       # State management (Provider pattern)
├── screens/         # UI screens
├── services/        # Business logic and API clients
├── widgets/         # Reusable UI components
└── main.dart        # App entry point

​

Cross-Platform Support

• Android (API level 21+)
• iOS (iOS 11.0+)

​

Core Features

​

Route Planning

• Multiple route options (fastest, cheapest)
• Transfer information
• Time-based scheduling
• Walking/local transport segments

​

Real-time Bus Schedules

• Live countdown timers
• Route information
• Destination details

​

Map Visualization

• Route polylines color-coded by transport mode
• Start/end/transfer markers
• Distance and duration statistics

​

User Favorites

​

File Structure

​

Configuration (config/)

• api_config.dart - API endpoints and Google Maps configuration
• app_theme.dart - Material Design theme settings

​

Models (models/)

• route_option.dart - Route search results
• route_leg.dart - Individual route segments
• bus_schedule.dart - Bus departure information
• favorite.dart - Saved route data
• node.dart - Campus locations/stops
• user.dart - User profile data
• campus_building.dart - Building information

​

Services (services/)

• api_service.dart - Base HTTP client
• route_service.dart - Route planning API
• bus_service.dart - Bus schedule API
• auth_service.dart - Authentication
• favorite_service.dart - Favorites management
• directions_service.dart - Google Maps Directions API

​

Screens (screens/)

• home/ - Route search interface
• buses/ - Upcoming bus schedules
• favorites/ - Saved routes
• route_map/ - Interactive map view
• profile/ - User settings
• auth/ - Login/authentication

​

Key Dependencies

dependencies:
  # Core Framework
  flutter:
    sdk: flutter
  
  # State Management
  provider: ^6.1.1
  
  # Networking
  http: ^1.1.0
  
  # Local Storage
  shared_preferences: ^2.2.2
  sqflite: ^2.3.0
  
  # UI Components
  google_fonts: ^6.1.0
  flutter_svg: ^2.0.9
  shimmer: ^3.0.0
  
  # Maps
  google_maps_flutter: ^2.5.0
  
  # Utilities
  intl: ^0.18.1
  flutter_dotenv: ^5.1.0

​

App Initialization

void main() async {
  // Initialize Flutter binding
  WidgetsFlutterBinding.ensureInitialized();

  // Load environment variables from .env file
  await dotenv.load(fileName: ".env");

  // Initialize AuthProvider
  final authProvider = AuthProvider();
  await authProvider.init();

  // Run app with MultiProvider
  runApp(
    MultiProvider(
      providers: [
        ChangeNotifierProvider.value(value: authProvider),
      ],
      child: const MyApp(),
    ),
  );
}

​

Navigation Structure

final List<Widget> _screens = [
  HomeScreen(),          // Route planning
  UpcomingBusesScreen(), // Bus schedules
  FavoritesScreen(),     // Saved routes
  ProfileScreen(),       // User profile
];

​

Environment Variables

• GOOGLE_DM_API_KEY - Google Maps/Directions API key
• Backend API URL is configured in lib/config/api_config.dart

​

Next Steps

• Installation Guide
• Configuration Setup
• Route Planning Features
• Services Documentation