eii/laravel-installer

A package to install Laravel applications with wizard steps.

1.0.4 2025-09-28 03:20 UTC

Requires

• php: ^8.1
• livewire/livewire: ^3.0

MIT

• Amit Haldar

README

This package features a multi-step wizard designed for a seamless Laravel application installation. It offers an intuitive interface that guides users through server requirement checks, environment configuration, database setup, and the creation of an initial admin user, all using Livewire components.

By including the Laravel installer in your application, you can eliminate the need to assist your clients with server setup. Clients can independently check server requirements, update the .env file, migrate the database, and link storage, all through a step-by-step installation guide.

Screenshots

Features

• Easy Installation: Easily Integrate in to your Laravel project.
• Step-by-Step Wizard: User-friendly interface for guided installation.
• Server Requirement Checks: Automatically verifies PHP version, extensions, and server configurations.
• Environment Setup: Configures .env file with database credentials, app name, and other essentials.
• Database Migration and Seeding: Runs migrations and seeds the database with initial data.
• Link-Storage: Runs storage link (configurable).
• Admin User Creation: Sets up a default administrator account securely.
• Livewire Integration: Dynamic, real-time updates, data validations without page reloads.
• Customizable: Easily extend or modify steps with additional livewire components to fit your application's needs.
• Error Handling: Graceful error messages and rollback options for failed installations.

Requirements

• PHP >= 8.1
• Laravel >= 10.0
• Composer >= 2.0
• Livewire >= 3.0

Installation

1. You can install the package via Composer:

composer require eii/laravel-installer

1. After installation, publish the package's assets and configuration:

php artisan vendor:publish --provider="Eii\Installer\InstallerServiceProvider" --tag=config
php artisan vendor:publish --provider="Eii\Installer\InstallerServiceProvider" --tag=views
php artisan vendor:publish --provider="Eii\Installer\InstallerServiceProvider" --tag=assets

1. Update the config/installer. (app_name, requirements, etc.)

Usage

• Navigate to /install in your browser to start the wizard.
• Follow the wizard steps to complete the installation.
• The wizard steps are defined in the config/laravel-installer.php file. You can add, remove, or reorder steps as needed.
• Modify the views published in resources/views/vendor/installer as needed.

Configuration

The configuration file is located at config/laravel-installer.php. Key options include:

• lock_file: Path to the installation lock file to prevent re-running the installer.
• redirect_after_install: URL to redirect to after successful installation.
• requirements: Array of server requirements to check (e.g., PHP version, extensions like pdo_mysql).

Troubleshooting

• Installation Fails on Requirements: Ensure your server meets the listed requirements. Check the Laravel documentation for setup guides.
• Database Connection Issues: Verify your .env credentials and that the database server is running.
• Livewire Not Working: Make sure Livewire is properly installed and assets are published.
• For more help, check the issues on GitHub or open a new one.

Contributing

Contributions are welcome! Please follow these steps:

1. Contributions are welcome! Please follow these steps:
2. Create a new branch (git checkout -b feature/YourFeature).
3. Commit your changes (git commit -m 'Add YourFeature').
4. Push to the branch (git push origin feature/YourFeature).
5. Open a Pull Request.

We appreciate bug reports, feature requests, and code improvements.

License

This package is open-sourced software licensed under the MIT license.

Credits

Amit Haldar (Eii Tech Solutions https://eiitechsolutions.com)
Built with Laravel and Livewire

If you find this package useful, consider starring the repository on GitHub!