Car-Repairs-Shop/README.md
sackey 46a49536bf
Some checks are pending
linter / quality (push) Waiting to run
tests / ci (push) Waiting to run
Update README.md
2025-08-10 19:50:40 +00:00

1.8 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

git clone https://git.safetracksystems.com/sackey/Car-Repairs-Shop.git cd Car-Repairs-Shop

2. **Install PHP dependencies:**
```bash
composer install
  1. Install Node.js dependencies:
    npm install
    
  2. Copy environment file and set up keys:
    cp .env.example .env
    php artisan key:generate
    
  3. Configure your database in .env
  4. Run migrations and seeders:
    php artisan migrate --seed
    
  5. Build frontend assets:
    npm run build
    
  6. 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