FleetFusion 🚚✨

Modern, Multi-Tenant SaaS for Fleet Management
Live Demo • Features • Tech Stack • Getting Started

---

FleetFusion is a next-gen SaaS platform for trucking companies to manage vehicles, drivers, loads, compliance, and analytics. Built with the latest Next.js, React Server Components, Prisma ORM, and Neon Postgres. 🚀

---

✨ Features

• 🚦 Dispatch Board: Drag-and-drop load assignment, real-time status, and notifications
• 🚚 Vehicle Management: Maintenance, inspections, compliance docs, and analytics
• 🧑‍✈️ Driver Management: Licensing, HOS, performance, and alerts
• 🛡️ Compliance: Central dashboard, document uploads, and automated reminders
• ⛽ IFTA Reporting: Automated miles/fuel, tax calculation, and export
• 📊 Analytics: Real-time dashboards for performance, utilization, and finance
• 🔐 Role-Based Access: Admin, Dispatcher, Driver, Compliance, Account Manager
• 🏢 Multi-Tenancy: Company-level data isolation and org-based access
• 🌗 Modern UI: Responsive, accessible, dark/light mode, mobile-friendly

---

🛠️ Tech Stack

• Frontend: Next.js 15 (App Router), React 19 (Server Components), Tailwind CSS 4
• Backend: Node.js/Edge, React Server Actions, Next.js API Routes
• Database: PostgreSQL (Neon), Prisma ORM
• Auth: Clerk (org-based, RBAC)
• Storage: Vercel Blob Storage
• Monitoring: Vercel Analytics
• Testing: Vitest, React Testing Library, Playwright
• Coverage: Codecov reports via GitHub Actions

---

---

🚀 Getting Started

Prerequisites

• Node.js 20+
• pnpm 8+
• Neon.tech Postgres or compatible
• Clerk account

Quickstart

git clone https://github.com/your-username/fleet-fusion.git
cd fleet-fusion
pnpm install
cp .env.example .env.local # Edit with your DATABASE_URL and DIRECT_URL
pnpm dev

Open http://localhost:3000

Running Tests

Install project dependencies before running tests:

pnpm install
pnpm test

Project Structure (App Router)

src/
  app/
    (marketing)/              # Public landing page
    (auth)/sign-in, sign-up/   # Auth group scaffolding (Clerk-ready)
    (tenant)/[orgId]/          # Tenant workspace with domain routes
      dispatch/                # Load board placeholder
      vehicles/                # Fleet readiness placeholder
      drivers/                 # Driver roster placeholder
      compliance/              # Document vault placeholder
      ifta/                    # Fuel + miles placeholder
      analytics/               # Reporting placeholder
      settings/                # Org + subscription placeholder
    api/health, api/ready/     # Health and readiness probes
  shared/                      # UI primitives, utils, hooks
  domains/                     # Domain modules (to be filled in)

PDF Storage Provider

Generated PDF reports are uploaded via a configurable provider. Set STORAGE_PROVIDER to filesystem (default) or s3. For S3, also define S3_BUCKET, S3_REGION, S3_PUBLIC_URL, AWS_ACCESS_KEY_ID, and AWS_SECRET_ACCESS_KEY. Local storage writes to the path defined in config/pdf.ts.

Feature Flags

FleetFusion supports runtime toggles via environment variables. See docs/feature-flags.md for details.

---

🆘 Help & Support

• Docs: See the /docs folder for user guides and technical docs
• FleetFusion Docs

---

Development Workflow

• Branch Names: feature/xyz, fix/abc, docs/doc-change
• PR Titles: [type]: short description (e.g., feat: add driver dashboard)
• Project Board: All issues/PRs are tracked on the Project Board.
• Milestones: Features are grouped by release milestones (e.g., Q3 2025).
• Merge Conflicts: See our Merge Conflict Resolution Guide for step-by-step help.
• CI Pipeline: Automated via GitHub Actions in ci.yml to lint, type-check, test, and deploy to Vercel.

See CONTRIBUTING.md for full guidelines.

Linting & Formatting

Run npm run lint to check code quality. Use npm run format to automatically format the project with Prettier.

---

📝 License

MIT License. See LICENSE for details.

---

FleetFusion – The Future of Fleet Management SaaS 🚚✨