Plan-B/ionic-planb-logistic-app-flutter
5
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
22 Commits 2 Branches 0 Tags 2.7 MiB
Dart 97.9%
Ruby 0.9%
Swift 0.7%
HTML 0.4%
98ce195bbb
Go to file
Jean-Philippe Brule 98ce195bbb Add delivery order badges and optimize list performance 
Enhance delivery list UI with sequential order badges and improve scrolling
performance with faster animations for better user experience.

Delivery Order Badge:
- Add 60x60px status-colored square badge showing delivery sequence number
- Position badge to the left of vertical status bar for clear visual hierarchy
- White text (26px, bold) centered in badge
- Automatically displays deliveryIndex + 1 (first delivery = 1, second = 2, etc.)
- Status color matches delivery state (green for completed, gray for pending, etc.)
- 10px border radius for modern appearance

Layout Enhancements:
- Sidebar expanded from 360px to 420px to accommodate order badges
- Vertical centering of row elements for better visual balance
- Maintains optimized spacing: badge (60px) + gap (12px) + bar (6px) + gap (16px) + content
- Full list scrolling restored (removed 4-item limit)

Animation Performance:
- Stagger animation delay reduced by 90% (50ms to 5ms)
- Fast stagger: 30ms to 3ms for ultra-responsive scrolling
- Delivery items appear almost instantly when scrolling
- Total animation time for 20 items: 500ms to 100ms
- Maintains subtle stagger effect while feeling immediate

User Experience Improvements:
- Clear visual indication of delivery order in route
- Faster perceived loading when scrolling through deliveries
- Better readability with larger, prominent order numbers
- Consistent status color coding across badge and accent bar

Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-17 10:29:17 -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 Upgrade Flutter packages and fix breaking changes for Riverpod 3.0 2025-11-16 01:25:16 -05:00
lib Add delivery order badges and optimize list performance 2025-11-17 10:29:17 -05:00
macos Upgrade Flutter packages and fix breaking changes for Riverpod 3.0 2025-11-16 01:25:16 -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 Upgrade Flutter packages and fix breaking changes for Riverpod 3.0 2025-11-16 01:25:16 -05:00
pubspec.yaml Upgrade Flutter packages and fix breaking changes for Riverpod 3.0 2025-11-16 01:25:16 -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