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

✨ What’s New in v1.1.2

1️⃣ Loading State for Action Buttons

• Added loading indicators to step action buttons (Next / Finish).
• Improves user experience during time-consuming operations.
• Clearly informs users that processing is in progress and prevents duplicate submissions.

2️⃣ Improved Environment Input Handling

• Automatic trimming of input values to prevent validation errors caused by trailing spaces (common when copying & pasting).
• Quoted environment values when saving to .env, ensuring:
  • SMTP passwords containing spaces work correctly
  • No unexpected server errors (HTTP 500) during mail configuration

3️⃣ Spatie Permission Compatibility

• Added compatibility with spatie/laravel-permission
• Ensures smooth integration for applications using role & permission management
• Merged via PR #8 (thanks @vince844 🙌)

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 by running the install command:

php artisan installer:install

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

• Resetting the Installer: During development, you can reset the installation state by clearing sessions, progress, and lock files:

  php artisan installer:reset

• 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.

Development

If you want to modify the styling of the installer, you can rebuild the CSS using Tailwind CSS:

1. Install dependencies:

   npm install

2. Build the assets:

   npm run build

3. For real-time development:

   npm run watch

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!