laravel-ui-installer maintained by imrostom
laravel-ui-installer
A plug-and-play multi-step browser-based installer for Laravel applications, styled with Tailwind CSS.
Installation
composer require imrostom/laravel-ui-installer
The package auto-discovers itself via Laravel's package discovery.
Usage
Visit /install in your browser and follow the wizard:
| Step | Route | Description |
|---|---|---|
| 1 | GET /install |
System requirements check |
| 2 | GET /install/database |
Database credentials + connection test |
| 3 | GET /install/admin |
Admin user creation + migrations |
| 4 | GET /install/finish |
Run seeders + mark installed |
Once installation is complete a storage/installed.lock file is created. All installer routes then redirect away automatically.
Publishing Assets
# Publish config
php artisan vendor:publish --tag=installer-config
# Publish views (to override UI)
php artisan vendor:publish --tag=installer-views
Configuration
config/installer.php:
return [
'php_version' => '8.1.0',
'extensions' => ['openssl', 'pdo', 'pdo_mysql', ...],
'functions' => ['proc_open', 'exec'],
'writable_paths' => ['storage', 'bootstrap/cache', ...],
'admin' => [
'model' => \App\Models\User::class,
'name_column' => 'name',
'email_column' => 'email',
'password_column' => 'password',
],
'seeders' => [], // optional seeder classes
'redirect_url' => '/login', // after installation
'route_prefix' => 'install', // URL prefix
'lock_file' => 'installed.lock', // relative to storage_path()
];
License
MIT