imrostom/laravel-ui-installer

A plug-and-play multi-step web installer UI for Laravel applications.

v1.0 2026-05-20 09:53 UTC

Requires

• php: ^8.2
• illuminate/database: ^10.0|^11.0|^12.0
• illuminate/http: ^10.0|^11.0|^12.0
• illuminate/support: ^10.0|^11.0|^12.0

MIT

• Rostom Ali

• installer
• wizard
• laravel
• setup
• tailwind

README

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