Car-Repairs-Shop/README.md
sackey fcff9900a2
Some checks failed
linter / quality (push) Has been cancelled
tests / ci (push) Has been cancelled
Update README.md
2025-08-10 19:51:13 +00:00

1.7 KiB

Car Repairs Shop

A modern Laravel-based application for managing car repair shop operations, built with Livewire, Volt, and Flux UI. This project streamlines customer management, appointments, inventory, service orders, technician management, and reporting.

Features

  • Customer and Vehicle Management
  • Appointment Scheduling
  • Service Orders and Estimates
  • Inventory and Parts Tracking
  • Technician Performance and Skills
  • Timesheets and Work Orders
  • Dashboard and Analytics
  • Role-based Permissions
  • Notifications

Tech Stack

  • Backend: Laravel 12, PHP 8.2
  • Frontend: Livewire, Volt, Flux UI, Tailwind CSS, Vite
  • Database: MySQL (default), SQLite (for testing)
  • Testing: PHPUnit

Installation

  1. Clone the repository:
    git clone https://git.safetracksystems.com/sackey/Car-Repairs-Shop.git
    cd Car-Repairs-Shop
    
  2. Install PHP dependencies:
    composer install
    
  3. Install Node.js dependencies:
    npm install
    
  4. Copy environment file and set up keys:
    cp .env.example .env
    php artisan key:generate
    
  5. Configure your database in .env
  6. Run migrations and seeders:
    php artisan migrate --seed
    
  7. Build frontend assets:
    npm run build
    
  8. Start the development server:
    php artisan serve
    

Usage

  • Access the app at http://localhost:8000
  • Login/register and start managing your car repair shop

Testing

Run all tests with:

./vendor/bin/phpunit

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

License

MIT