Plan-B/ionic-planb-logistic-app-flutter
5
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1 Commit 1 Branch 0 Tags 1.4 MiB
Dart 96.8%
Ruby 1.3%
HTML 1.2%
Swift 0.6%
Kotlin 0.1%
main
Go to file
Claude Code 4b03e9aba5 Initial commit: Plan B Logistics Flutter app with dark mode and responsive design 
Implements complete refactor of Ionic Angular logistics app to Flutter/Dart with:
- Svrnty dark mode console theme (Material Design 3)
- Responsive layouts (mobile, tablet, desktop) following FRONTEND standards
- CQRS API integration with Result<T> error handling
- OAuth2/OIDC authentication support (mocked for initial testing)
- Delivery route and delivery management features
- Multi-language support (EN/FR) with i18n
- Native integrations (camera, phone calls, maps)
- Strict typing throughout codebase
- Mock data for UI testing without backend

Follows all FRONTEND style guides, design patterns, and conventions.
App is running in dark mode and fully responsive across all device sizes.

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-31 04:58:10 -04:00
android Initial commit: Plan B Logistics Flutter app with dark mode and responsive design 2025-10-31 04:58:10 -04: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 Initial commit: Plan B Logistics Flutter app with dark mode and responsive design 2025-10-31 04:58:10 -04:00
lib Initial commit: Plan B Logistics Flutter app with dark mode and responsive design 2025-10-31 04:58:10 -04:00
test Initial commit: Plan B Logistics Flutter app with dark mode and responsive design 2025-10-31 04:58:10 -04:00
web Initial commit: Plan B Logistics Flutter app with dark mode and responsive design 2025-10-31 04:58:10 -04:00
.gitignore Initial commit: Plan B Logistics Flutter app with dark mode and responsive design 2025-10-31 04:58:10 -04:00
.metadata Initial commit: Plan B Logistics Flutter app with dark mode and responsive design 2025-10-31 04:58:10 -04: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
CLAUDE.md Initial commit: Plan B Logistics Flutter app with dark mode and responsive design 2025-10-31 04:58:10 -04: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 Initial commit: Plan B Logistics Flutter app with dark mode and responsive design 2025-10-31 04:58:10 -04:00
pubspec.yaml Initial commit: Plan B Logistics Flutter app with dark mode and responsive design 2025-10-31 04:58:10 -04:00
README.md Initial commit: Plan B Logistics Flutter app with dark mode and responsive design 2025-10-31 04:58:10 -04: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