liberu-maintenance/maintenance-laravel

The skeleton application for the Laravel framework.

dev-main 2026-02-04 21:08 UTC

Requires

• php: ^8.5
• bezhansalleh/filament-shield: ~4.0
• filament/filament: ^5.0
• filament/spatie-laravel-settings-plugin: ^5.0
• guzzlehttp/guzzle: ^7.8
• joelbutcher/socialstream: ^6.0
• laravel/framework: ^12.0
• laravel/jetstream: ^5.1
• laravel/sanctum: ^4.0
• laravel/tinker: ^2.9
• livewire/livewire: ^4.0
• spatie/laravel-menu: ^4.2

Requires (Dev)

• fakerphp/faker: ^1.23
• filament/upgrade: ^5.0
• laravel/pint: ^1.14
• laravel/sail: ^1.28
• mockery/mockery: ^1.6
• nunomaduro/collision: ^8.0
• phpunit/phpunit: ^12.3
• spatie/laravel-ignition: ^2.4

MIT

• framework
• laravel

README

A lightweight, open-source Computerised Maintenance Management System (CMMS) built with Laravel, Livewire and Filament. Designed to help teams manage equipment, maintenance schedules, work orders, tasks and notifications.

Key technologies: PHP · Laravel · Filament · Livewire · Jetstream

Quick start

Minimum requirements

• PHP ^8.5
• Composer
• A database (MySQL, Postgres, etc.)

Recommended (one-time)

# from project root (Unix-like shells)
./setup.sh

Manual steps

composer install
cp .env.example .env
php artisan key:generate
php artisan migrate --seed

Notes

• setup.sh may prompt and overwrite .env — review before accepting.
• Seeders install sample data; skip them if you prefer an empty DB.

Docker / Local dev

Build and run the image locally:

docker build -t maintenance-laravel .
docker run -p 8000:8000 maintenance-laravel

Or use Laravel Sail for local development:

./vendor/bin/sail up

What it provides

• Equipment inventory and status
• Maintenance schedules and one-off maintenance
• Work orders, tasks and assignment workflows
• Team and user management (Jetstream + Teams)
• Notifications, reports and custom forms

The codebase uses a modular architecture to make extensions and integrations straightforward.

Related projects

Project	Repository
Accounting	liberu-accounting/accounting-laravel
Automation	liberu-automation/automation-laravel
Billing	liberu-billing/billing-laravel
Boilerplate	liberusoftware/boilerplate
Browser Game	liberu-browser-game/browser-game-laravel
CMS	liberu-cms/cms-laravel
Control Panel	liberu-control-panel/control-panel-laravel
CRM	liberu-crm/crm-laravel
E-commerce	liberu-ecommerce/ecommerce-laravel
Genealogy	liberu-genealogy/genealogy-laravel
Maintenance (this)	liberu-maintenance/maintenance-laravel
Real Estate	liberu-real-estate/real-estate-laravel
Social Network	liberu-social-network/social-network-laravel

Contributing

Contributions welcome. Open an issue to propose larger changes before submitting a pull request so we can coordinate.

License

MIT — see the LICENSE file for details.

Contributors