No description
Find a file
Dave 8a51f4851b feat(grouping): add per-invoice grouping with bulk collect/problem
Drivers can now switch the header toggle to 'Invoice' to see stops
bucketed by PO within each supplier. Each PO sub-header is
collapsible and shows the PO number + item count + total qty.

Per-PO bulk actions (visible only when the supplier has more than
one invoice):
- Green 'All' button marks every item under that PO as collected
  in one tap (no per-item modal flow, expectedQty is auto-stamped).
- Red flag button flags every item with a generic problem note.

Implementation:
- New 'po' groupMode in app/page.tsx with its own groupedByPO memo
  and expandedPOs Set state (auto-expanded on load, controlled by
  expandAll/collapseAll alongside supplier expansion).
- SupplierGroup now accepts optional poGroups + handlers and renders
  PO sub-headers in compact mode. Each PO is rendered as a flat
  list of CompactItemRow subcomponents (extracted to share the row
  markup between flat-list and per-PO render paths).
- bulkCollect / bulkProblem helpers in lib/pocketbase.ts loop the
  patch; per-row failures are logged and excluded from the count so
  one bad row doesn't poison the batch.

Co-authored-by: Orca <help@stably.ai>
2026-08-12 08:04:26 +02:00
.claude Add Playwright logs & settings; update app page 2026-06-10 00:05:06 +02:00
.playwright-mcp Add Playwright logs & settings; update app page 2026-06-10 00:05:06 +02:00
.vscode feat: initialize project with Next.js, TypeScript, and Tailwind CSS 2026-05-24 21:51:29 +02:00
app feat(grouping): add per-invoice grouping with bulk collect/problem 2026-08-12 08:04:26 +02:00
components feat(grouping): add per-invoice grouping with bulk collect/problem 2026-08-12 08:04:26 +02:00
e2e feat: add order item photo uploads and fix PB bugs 2026-07-08 01:35:26 +02:00
lib docs(pocketbase): clarify driver/drv_id schema — operator app fix needed 2026-08-12 08:04:19 +02:00
public feat: add pickup proof photos, improve performance and UX 2026-07-07 20:43:17 +02:00
scripts feat: add PO/Notes popovers, supplier color sidebar, fix popover clipping 2026-08-02 21:38:38 +02:00
.dockerignore feat: initialize project with Next.js, TypeScript, and Tailwind CSS 2026-05-24 21:51:29 +02:00
.DS_Store feat: add pickup proof photos, improve performance and UX 2026-07-07 20:43:17 +02:00
.env.example feat: initialize project with Next.js, TypeScript, and Tailwind CSS 2026-05-24 21:51:29 +02:00
.gitignore Add PWA support and UI redesign 2026-05-27 00:34:50 +02:00
api-response.json Add Playwright logs & settings; update app page 2026-06-10 00:05:06 +02:00
Dockerfile Add PWA support and UI redesign 2026-05-27 00:34:50 +02:00
import_suppliers.py Refactor collections to order items 2026-05-25 00:47:47 +02:00
next-env.d.ts feat: initialize project with Next.js, TypeScript, and Tailwind CSS 2026-05-24 21:51:29 +02:00
next.config.js Add PWA support and UI redesign 2026-05-27 00:34:50 +02:00
nginx.conf Add PWA support and UI redesign 2026-05-27 00:34:50 +02:00
package-lock.json feat: add PO/Notes popovers, supplier color sidebar, fix popover clipping 2026-08-02 21:38:38 +02:00
package.json feat: add PO/Notes popovers, supplier color sidebar, fix popover clipping 2026-08-02 21:38:38 +02:00
postcss.config.js feat: initialize project with Next.js, TypeScript, and Tailwind CSS 2026-05-24 21:51:29 +02:00
README.md feat: initialize project with Next.js, TypeScript, and Tailwind CSS 2026-05-24 21:51:29 +02:00
screenshot-settings.png Add Playwright logs & settings; update app page 2026-06-10 00:05:06 +02:00
tailwind.config.js feat: shrink PO/Notes buttons, lift popover stacking, responsive header 2026-08-02 22:42:40 +02:00
tsconfig.json feat: initialize project with Next.js, TypeScript, and Tailwind CSS 2026-05-24 21:51:29 +02:00
tsconfig.tsbuildinfo feat(grouping): add area grouping, refine UI and cleanup 2026-07-10 02:01:57 +02:00

1Driver - Mobile Collections App

A standalone mobile-first PWA app for drivers to manage collections in the field.

Features

  • Mobile-first design - Optimized for phone use with touch-friendly UI
  • PWA support - Install as a standalone app on iOS and Android
  • Location tracking - Background location pings at configurable intervals
  • Collection list - View assigned collections grouped by supplier
  • Map view - See all collection stops on an interactive Leaflet map
  • Offline support - Queue actions when offline and sync when connected
  • Problem reporting - Report issues with photos and problem types

Screens

  1. List View - Shows all assigned collections for today/tomorrow, grouped by supplier
  2. Map View - Shows collection stops on a map with navigation integration
  3. Settings - Configure location tracking interval, accuracy, and display options

Tech Stack

  • Next.js 14 (App Router)
  • TypeScript
  • Tailwind CSS
  • PocketBase SDK
  • Leaflet / React Leaflet
  • Lucide Icons

PocketBase Integration

The app connects to your PocketBase instance at:

https://pocketbase-gnqc88suy8fqk6wyryjjdpvl.169.239.180.130.sslip.io

Required Collections

  1. collections - The main collection items (already exists)
  2. collection_problems - Problem reports
    Fields:
    - collection (relation to collections)
    - problem_type (select: out_of_stock, partial_stock, quality_issue, wrong_item, other)
    - description (text)
    - photo (file)
    - reported_at (date)
    
  3. driver_locations - Location tracking data
    Fields:
    - driver (relation to users)
    - latitude (number)
    - longitude (number)
    - accuracy (number, optional)
    - altitude (number, optional)
    - speed (number, optional)
    - heading (number, optional)
    - timestamp (date)
    
  4. order_items - Order items (already exists)
  5. suppliers - Supplier data with lat/lng (already exists)

Development

# Install dependencies
npm install

# Run development server
npm run dev

# Build for production
npm run build

Deployment

The app is configured for static export. Build output goes to the dist/ folder.

For PWA deployment, serve the dist/ folder with any static file server.

iOS Installation

  1. Open the app URL in Safari
  2. Tap the Share button
  3. Tap "Add to Home Screen"
  4. The app will install as a standalone PWA

Android Installation

  1. Open the app URL in Chrome
  2. Tap the menu (3 dots)
  3. Tap "Add to Home Screen" or "Install App"

Location Permissions

The app requires location permissions for:

  • Showing your current position on the map
  • Tracking driver locations at set intervals
  • Calculating distances to collection stops

Notes

  • Location tracking runs in the background while the app is open
  • The app uses the PocketBase users collection for authentication
  • Collections are filtered to show only those assigned to the logged-in driver
  • Status updates (collected/problem) sync immediately when online