almirfrances/tanzainstaller

A Laravel package for a multistep installation wizard

v1.0.0 2024-12-13 23:40 UTC

This package is auto-updated.

Last update: 2025-05-14 01:27:44 UTC


README

Packagist Version PHP Version License Downloads

TanzaInstaller is a Laravel package that provides a seamless multistep installation wizard for your Laravel applications. It ensures proper configuration of your application in a user-friendly manner.

Features

  • Multistep installation wizard
  • Dynamic configuration updates
  • Middleware to ensure installation is complete
  • Easily customizable and extensible

Installation

Step 1: Install the package

Run the following command in your Laravel application:

composer require almirfrances/tanzainstaller --dev

Step 2: Publish the package assets

Publish the package configuration and views using the command:

php artisan vendor:publish --tag=tanzainstaller

Step 3: Configure the .env

Ensure the following variables are in your .env file:

INSTALLER_INSTALLED=false

Middleware

This package includes middleware to ensure that the application cannot be accessed until the installation is complete. The middleware automatically redirects to /install if the application is not installed.

Example .env Configuration

APP_NAME=Laravel
APP_ENV=local
APP_KEY=
APP_DEBUG=false
APP_TIMEZONE=UTC
APP_URL=http://localhost


DB_CONNECTION=mysql
DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=
DB_USERNAME=
DB_PASSWORD=

SESSION_DRIVER=file
SESSION_LIFETIME=120
SESSION_ENCRYPT=false
SESSION_PATH=/
SESSION_DOMAIN=null

CACHE_STORE=file
CACHE_PREFIX=

INSTALLER_INSTALLED=false

Contributing

Contributions are welcome! Please submit a pull request or open an issue to discuss improvements or bug fixes. License

TanzaInstaller is open-sourced software licensed under the MIT license.

Author: Almir Frances
GitHub: almirfrances