# FleetLume UI v4 Release Notes

## New visual system

FleetLume now uses a cleaner fleet-operations interface with:

- Redesigned executive dashboard with a welcome/health header
- Eight compact operational KPI cards
- Cleaner load table, workflow, schedule, alert, and activity panels
- Refined typography, spacing, icons, status colors, buttons, forms, and tables
- Lighter content surfaces with a premium blue navigation system
- Updated login experience

## Responsive behavior

- Desktop sidebar is compact, grouped, collapsible, and remembers its state
- Tablet navigation switches to an off-canvas drawer
- Mobile dashboard has a dedicated stacked layout rather than a squeezed desktop layout
- Mobile bottom navigation provides Dashboard, Loads, Map, Alerts, and More shortcuts
- Tables become labeled cards on narrow screens
- Forms collapse from four/three/two columns to one column as space becomes limited
- Dispatch boards retain horizontal touch scrolling
- Calendars and HOS charts use controlled scroll containers
- Buttons and inputs use touch-friendly dimensions
- Safe-area spacing is included for modern phones

## Dashboard changes

The new dashboard presents:

- Live tracking, cold-chain, compliance, and document health
- Monthly dispatch-fee summary
- Active loads and carriers
- Available trucks, trailers, and drivers
- Reefer temperature alerts
- Pending invoices and expenses
- Border attention
- Recent loads
- Operational workflow
- Pickup/delivery schedule
- Operational alerts
- Recent system activity
- Mobile quick actions

## Cache update

UI v4 uses a new service-worker cache and network-first static-asset updates. Existing installations should still perform a hard refresh after upgrading.

## Files added or updated

- `public/assets/css/app-v4.css`
- `public/assets/js/app-v4.js`
- `app/Views/dashboard/index.php`
- `app/Views/layouts/app.php`
- `app/Views/layouts/auth.php`
- `app/Views/partials/sidebar.php`
- `app/Views/partials/topbar.php`
- `public/service-worker.js`
- `public/manifest.json`

No database migration is required for this UI release.
