DROPly Driver

A mobile-first driver app for DROPly — accept deliveries, call vendors and customers, follow the guided pickup → delivery flow, and withdraw earnings.

Built on the same Next.js scaffold as the customer and vendor apps (TanStack Query, Axios, NextAuth credentials, proxy middleware, shared DROPly orange/black branding).

Prerequisites

• Node.js >= 20.9.0
• An API backend that exposes /auth/login and /auth/session-details (not required yet — the app runs on a demo store, see below)

Environment Variables

Create a .env file in the project root and add the following:

NEXTAUTH_SECRET=your_random_secret_key
NEXT_PUBLIC_API_BASE_URL=https://api.example.com
API_BASE_URL=https://api.example.com

Variable	Description
NEXTAUTH_SECRET	Secret used by NextAuth to sign JWTs and session tokens.
NEXT_PUBLIC_API_BASE_URL	Public API base URL used by the browser-side Axios client.
API_BASE_URL	Server-side API base URL used by the Next.js server.

Installation

npm install

Running the App

npm run dev

Open http://localhost:3000 — it redirects to /driver. Sign in with any phone number + PIN (demo auth).

Backend seam

There is no driver backend yet. All delivery requests, wallet data, and auth run through a demo store:

• src/features/driver/api/demo-store.ts — one action per future API call (acceptDelivery → POST /deliveries/:id/accept, requestWithdrawal → POST /driver/withdrawals, etc.). Each action has a TODO(backend) note.
• src/features/driver/api/driver-auth.ts — sessionStorage session; swap for real apiClient calls when the API lands.

Routes

Route	Screen
/driver	Home — online toggle + available requests
/driver/deliveries	Active + completed deliveries
/driver/deliveries/[id]	Delivery details — contacts, call/map, next step
/driver/wallet	Balance, earnings, withdraw, history
/driver/profile	Account details + logout
/driver/login	Phone + PIN sign-in

Learn More

• AGENTS.md — scaffold conventions (routes stay thin, features implement).