Laravel Application Installer Package

The Laravel Installer package by Olakunle provides a flexible, plugin-based installation wizard for Laravel 12+ applications. Instead of forcing users to manually edit .env files or run terminal commands, this package allows you to offer a polished "Next, Next, Finish" setup experience.

It is built with the TALL stack (Tailwind, Alpine, Livewire, Laravel) and features a modern, dark-mode ready design.

#Key Features

• Plugin Architecture: Extend the installer with official packages or custom steps.
• Requirements Check: Automatically verifies PHP version and extensions.
• Permissions Check: Ensures critical folders like storage and bootstrap/cache are writable.
• Environment Setup: A GUI for configuring App, Database, and Mail settings.
• Zero-Config: Works out of the box with sensible defaults.
• Livewire 3: Uses the latest Livewire for a smooth, single-page-app feel.
• Dark Mode: Fully supports dark mode natively.

#Usage

You can install the package via Composer:

composer require olakunlevpn/laravel-installer

After installing, publish the configuration file to customize your steps:

php artisan vendor:publish --tag=laravel-installer-config

You can then define the flow of your installation wizard in config/installer.php. Here is an example of a standard setup flow:

'steps' => [
    \Olakunlevpn\Installer\Steps\WelcomeStep::class,
    \Olakunlevpn\Installer\Steps\RequirementsStep::class,
    \Olakunlevpn\Installer\Steps\PermissionsStep::class,
    \Olakunlevpn\Installer\Steps\EnvironmentStep::class,
    \Olakunlevpn\Installer\Steps\InstallingStep::class,
    \Olakunlevpn\Installer\Steps\CompletedStep::class,
],

The package is designed to be "framework aware," meaning it handles validation intelligently. For example, it won't attempt to validate database rules like unique:users before the database connection is even established.

#Plugins

The installer can be extended with official plugins to add more functionality:

• Welcome Plugin: A branded landing page for your installer.
• License Verification: Verify purchase codes via an API (great for Envato authors).
• Account Setup: Create the initial admin user as part of the installation process.

#Learn More

To get started with the Laravel Installer, check out the official documentation. You can also view the source code on GitHub to see how it works or contribute.