Plan-B/ionic-planb-logistic-app-flutter
5
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
13 Commits 2 Branches 0 Tags 2.7 MiB
Dart 97.9%
Ruby 0.9%
Swift 0.7%
HTML 0.4%
611e9eb2dd
Go to file
Jean-Philippe Brule 611e9eb2dd Implement iOS permissions, navigation improvements, and UI fixes 
Add comprehensive iOS permission handling and enhance navigation UX:

iOS Permissions Setup:
- Configure Podfile with permission macros (PERMISSION_LOCATION, PERMISSION_CAMERA, PERMISSION_PHOTOS)
- Add camera and photo library usage descriptions to Info.plist
- Enable location, camera, and photos permissions for permission_handler plugin
- Clean rebuild of iOS dependencies with updated configuration

Navigation Enhancements:
- Implement Google Navigation dark mode with custom map styling
- Add loading overlay during navigation initialization with progress messages
- Fix navigation flow with proper session initialization and error handling
- Enable followMyLocation API for continuous driver location tracking
- Auto-recenter camera on driver location when navigation starts
- Add mounted checks to prevent unmounted widget errors

UI/UX Improvements:
- Fix layout overlapping issues between map, header, and footer
- Add dynamic padding (110px top/bottom) to accommodate navigation UI elements
- Reposition navigation buttons to prevent overlap with turn-by-turn instructions
- Wrap DeliveriesPage body with SafeArea for proper system UI handling
- Add loading states and disabled button behavior during navigation start

Technical Details:
- Enhanced error logging with debug messages for troubleshooting
- Implement retry logic for navigation session initialization (30 retries @ 100ms)
- Apply dark mode style with 500ms delay for proper map rendering
- Use CameraPerspective.tilted for optimal driving view
- Remove manual camera positioning in favor of native follow mode

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-15 23:56:20 -05:00
android Fix Google Navigation initialization timing issues 2025-11-15 20:49:20 -05:00
assets/fonts Initial commit: Plan B Logistics Flutter app with dark mode and responsive design 2025-10-31 04:58:10 -04:00
ios Implement iOS permissions, navigation improvements, and UI fixes 2025-11-15 23:56:20 -05:00
lib Implement iOS permissions, navigation improvements, and UI fixes 2025-11-15 23:56:20 -05:00
macos Fix Google Navigation initialization timing issues 2025-11-15 20:49:20 -05:00
test Initial commit: Plan B Logistics Flutter app with dark mode and responsive design 2025-10-31 04:58:10 -04:00
web ios build, connected data (not finished) 2025-11-14 12:27:40 -05:00
.gitignore Initial commit: Plan B Logistics Flutter app with dark mode and responsive design 2025-10-31 04:58:10 -04:00
.metadata ios build, connected data (not finished) 2025-11-14 12:27:40 -05:00
analysis_options.yaml Initial commit: Plan B Logistics Flutter app with dark mode and responsive design 2025-10-31 04:58:10 -04:00
CHECKLIST.md ios build, connected data (not finished) 2025-11-14 12:27:40 -05:00
CLAUDE.md Initial commit: Plan B Logistics Flutter app with dark mode and responsive design 2025-10-31 04:58:10 -04:00
GOOGLE_MAPS_SETUP.md ios build, connected data (not finished) 2025-11-14 12:27:40 -05:00
GOOGLE_NAVIGATION_SETUP.md Implement Google Navigation Flutter integration for turn-by-turn delivery navigation 2025-11-15 20:43:29 -05:00
IMPLEMENTATION_SUMMARY.md Implement Google Navigation Flutter integration for turn-by-turn delivery navigation 2025-11-15 20:43:29 -05:00
l10n.yaml Initial commit: Plan B Logistics Flutter app with dark mode and responsive design 2025-10-31 04:58:10 -04:00
pubspec.lock ios build, connected data (not finished) 2025-11-14 12:27:40 -05:00
pubspec.yaml ios build, connected data (not finished) 2025-11-14 12:27:40 -05:00
README.md Initial commit: Plan B Logistics Flutter app with dark mode and responsive design 2025-10-31 04:58:10 -04:00
UI_UX_IMPROVEMENTS.md Add comprehensive UI/UX improvements documentation 2025-11-15 14:42:16 -05:00

README.md

Plan B Logistics - Flutter Mobile App

A complete Flutter/Dart refactoring of the Plan B Logistics delivery management system. Built with Material Design 3, Svrnty brand colors, and CQRS architecture for type-safe API integration.

Overview

This is a mobile delivery management application for logistics personnel to:

  • View assigned delivery routes with progress tracking
  • Manage individual deliveries (complete, uncomplete, skip)
  • Capture photos as delivery proof
  • Call customers and navigate to delivery addresses
  • Manage app settings and language preferences
  • Secure authentication via OAuth2/OIDC with Keycloak

Built with:

  • Flutter 3.9+ / Dart 3.9.2+
  • Material Design 3 with Svrnty theming (Crimson & Slate Blue)
  • Riverpod for state management
  • CQRS pattern with Result error handling
  • Strict typing (no dynamic)

Quick Start

Prerequisites

  • Flutter SDK 3.9.2+: Install Flutter
  • Dart SDK 3.9.2+ (included with Flutter)

Setup

cd ionic-planb-logistic-app-flutter
flutter pub get

Run

flutter run                # Android/iOS default device
flutter run -d chrome      # Web
flutter run -d ios         # iOS simulator
flutter run -d android     # Android emulator

Project Structure

lib/
├── api/              # CQRS client & types
├── models/           # Data models
├── services/         # Auth service
├── providers/        # Riverpod state
├── pages/            # Login, Routes, Deliveries, Settings
├── l10n/             # Translations (EN/FR)
├── theme.dart        # Svrnty Material Design 3
└── main.dart         # Entry point

Key Features

  • OAuth2/OIDC Authentication with Keycloak
  • CQRS API Integration with Result error handling
  • Riverpod State Management for reactive UI
  • Internationalization (English & French)
  • Material Design 3 with Svrnty brand colors
  • Native Features: Camera, Phone calls, Maps
  • Strict Typing: No dynamic type allowed

Development

See CLAUDE.md for:

  • Detailed architecture & patterns
  • Code standards & conventions
  • API integration examples
  • Development workflow

Build Commands

flutter build web --release        # Web
flutter build ios --release         # iOS
flutter build appbundle --release   # Android (Play Store)

Documentation

  • CLAUDE.md - Complete development guidelines
  • pubspec.yaml - Dependencies and configuration
  • Flutter Docs - Official documentation

Version

1.0.0+1

Svrnty Edition