Majestic Transport System

Majestic Transport is a multi-tenant fleet and trip management platform. The system coordinates vehicle logistics, driver assignments, and real-time trip execution through a unified backend and specialized client applications.

Core Components

🧠 Backend API (apps/api)

The central engine managing data persistence, business logic, and security.

• Framework: Hono (Node.js/Edge).
• Database: PostgreSQL + Drizzle ORM.
• Auth: Better Auth (supporting Sessions, Passkeys, and Organizations).
• Validation: Strict Zod-based schemas shared across the ecosystem.

🖥️ Admin Dashboard (apps/admin)

A web-based interface for management and dispatch.

• Tech: React 19 + Vite + TanStack Router/Query.
• Purpose: Fleet oversight, scheduling, and organizational management.

📱 Driver App (apps/driver)

A native mobile application for field personnel.

• Tech: Expo + React Native + NativeWind.
• Purpose: Trip execution, real-time updates, and vehicle handover snapshots.

---

Technical Architecture

The project is structured as a Turborepo Monorepo, ensuring that business rules defined in the packages/schema are identically enforced in both the mobile app and the admin dashboard. This prevents "data drift" and ensures that if a requirement changes (e.g., a mandatory field for a car), it updates across all platforms simultaneously.