mathias
edb106a7fd
- Overhaul theme system with Svrnty design and WCAG AAA compliance - Remove android, macos, and web platform files (iOS-only focus) - Update components with improved dark mode map and UI refinements - Enhance settings page with additional configuration options - Add theme system documentation in lib/theme/README.md - Update CLAUDE.md with comprehensive theme guidelines Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
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
dynamictype 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