Skip to content

A lightweight Driver Registration & Admin Dashboard system built with Laravel. — clean, mobile-first UI, file uploads, email confirmation, and admin PDF export.

Notifications You must be signed in to change notification settings

Richmond-Nunoo/laravel-driver-management

Repository files navigation

Laravel Logo

Build Status Total Downloads Latest Stable Version License


🚚 Driver Registration System – Laravel Project

A lightweight Driver Registration & Admin Dashboard system built with Laravel. Designed and developed as a 24-hour MVP to quickly manage driver registrations, including document uploads, email confirmations, and admin review/export.


🖼️ Screenshots

📱 Mobile View (Split into 3)

💻 Desktop View

Driver View

🌐 Live Demo


👨‍✈️ Driver Features

  • Clean, mobile-friendly UI
  • Driver registration with:
    • Full name
    • Email (must be unique)
    • Phone (10 digits)
    • Truck type
    • Document upload (PDF, JPG, PNG)
  • Email confirmation after submission
  • Check registration status via phone/email
  • Driver dashboard confirmation view

🛡️ Admin Features

  • Dedicated admin login via /admin/login
  • View all registered drivers in dashboard
  • Export drivers list to PDF
  • Protected admin routes using custom guard

🔐 Default Admin Login (for testing)

⚠️ Please change these credentials before deploying to production.


🚀 Getting Started Locally

1. Clone the Repository

git clone https://github.com/Richmond-Nunoo/laravel-driver-management.git
cd driver-management


2. Install Dependencies
composer install
npm install && npm run dev


3. Environment Setup
cp .env.example .env
php artisan key:generate

4. Run Migrations & Seed Default Admin
php artisan migrate --seed

5. Start Development Server
php artisan serve


Local Driver URL: http://127.0.0.1:8000

Local Admin URL: http://127.0.0.1:8000/admin/login


📸 Screenshots


🛠️ Tech Stack
Laravel 10.x

Bootstrap 5 (UI)

DomPDF (PDF export)

Laravel Mail (for confirmation)

📁 Folder Structure
app/
 ├── Http/Controllers/
 │    ├── DriverController.php
 │    └── Admin/
 │         └── AuthController.php
 ├── Models/
 │    ├── Driver.php
 │    └── Admin.php
resources/views/
 ├── index.blade.php
 ├── drivers/
 └── admin/

🤝 Contributing
Pull requests are welcome!
For major changes, please open an issue first to discuss what you'd like to contribute.

About

A lightweight Driver Registration & Admin Dashboard system built with Laravel. — clean, mobile-first UI, file uploads, email confirmation, and admin PDF export.

Topics

Resources

Stars

Watchers

Forks