Fleet Management & RX Delivery Inspection Platform.
This application is a specialized logistics management platform designed to track pharmacy (RX) delivery driver inspections, route assignments, and vehicle conditions. It replaces paper logs with a digital, type-safe, and mobile-responsive solution.
- Framework: Next.js 15 (App Router)
- Language: TypeScript
- Styling: Tailwind CSS (Responsive Mobile/Desktop)
- Backend & Auth: Supabase (Postgres, Auth, Storage)
- Deployment: Vercel
- Smart Inspection Forms: Dynamic Pre-Trip and Post-Trip logic. Questions change based on the selected trip type.
- Condition Reporting: Conditional logic requires drivers to describe issues if "No" is selected on safety checks (or "Yes" on damage checks).
- Photo Evidence: Integrated file uploading for Front, Back, and Trunk vehicle photos (stored in Supabase Buckets).
- Tire Pressure Logging: Dedicated inputs for tire PSI during Pre-Trip inspections.
- Dynamic Routes: Route selection dropdown pulls live data from the database, allowing admins to update routes without code changes.
- Drivers: Can only view and edit their own logs for a limited time window. Mobile-optimized "Card View" for easy use on phones.
- Management: Read-only access to all driver logs and exports.
- Admins: Full access to Edit/Delete any log, manage routes, and view global history.
- One-Click Exports: Generate PDF reports for individual inspections (including photos) or export data to CSV.
- Live Contact Roster: Auto-updating "Contacts" page that separates Drivers from Management based on registration titles.
Follow these steps to set up the project locally on your machine.
- Node.js (v18 or higher)
- A Supabase project (for DB and Auth)
-
Clone the repository:
git clone https://github.com/idongCodes/symbria-delivery-logistics.git cd symbria-delivery-logistics -
Install dependencies:
npm install
-
Configure Environment Variables: Create a
.env.localfile in the root directory and add your Supabase credentials:NEXT_PUBLIC_SUPABASE_URL=your_supabase_project_url NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
-
Run the development server:
npm run dev
-
Open the app: Visit http://localhost:3000 in your browser.
The application relies on the following key tables in Postgres:
auth.users: Managed by Supabase Auth.public.profiles: Extends user data (Job Title, Phone, First/Last Name).public.trip_logs: Stores inspection data, JSON checklists, image URLs, and odometer readings.public.routes: Stores the list of active delivery routes.storage.buckets: 'trip_logs' bucket stores vehicle images.
- Fork the repository.
- Create a new branch (
git checkout -b feature/your-feature). - Commit your changes (
git commit -m 'Add some feature'). - Push to the branch (
git push origin feature/your-feature). - Open a Pull Request.
This project is proprietary. All rights reserved.