PHPackages                             bijanbiria/laravel-deploy-wizard - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [DevOps &amp; Deployment](/categories/devops)
4. /
5. bijanbiria/laravel-deploy-wizard

ActiveLibrary[DevOps &amp; Deployment](/categories/devops)

bijanbiria/laravel-deploy-wizard
================================

A Laravel Installer Wizard similar to WordPress installation process

1.1.3(1y ago)250MITPHPPHP &gt;=8.2

Since May 10Pushed 1y ago1 watchersCompare

[ Source](https://github.com/bijanbiria/LaravelDeployWizard)[ Packagist](https://packagist.org/packages/bijanbiria/laravel-deploy-wizard)[ RSS](/packages/bijanbiria-laravel-deploy-wizard/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (1)Dependencies (1)Versions (4)Used By (0)

Laravel Deploy Wizard
=====================

[](#laravel-deploy-wizard)

[![Latest Stable Version](https://camo.githubusercontent.com/f33e3e09e3f24c3f9c943d620dae488810e3fef625eb421875007cb2f4c8c30b/68747470733a2f2f706f7365722e707567782e6f72672f62696a616e62697269612f6c61726176656c2d6465706c6f792d77697a6172642f762f737461626c65)](https://packagist.org/packages/bijanbiria/laravel-deploy-wizard)[![License](https://camo.githubusercontent.com/7888a5342ee127900b7fdfaed2b48d9eafb8cfcc0c4633f7c6269aa8df12bedb/68747470733a2f2f706f7365722e707567782e6f72672f62696a616e62697269612f6c61726176656c2d6465706c6f792d77697a6172642f6c6963656e7365)](https://packagist.org/packages/bijanbiria/laravel-deploy-wizard)

Laravel Deploy Wizard is a powerful Laravel Installer inspired by the WordPress installation process. It provides a user-friendly wizard for setting up Laravel applications easily, handling environment configuration, database setup, and executing necessary Artisan commands.

---

🚀 **Features**
--------------

[](#-features)

- Interactive step-by-step setup wizard
- Automatic `.env` file generation if it does not exist
- Database connection setup and validation
- Route-based installation flow (`deploy-wizard` by default)
- Support for publishing configuration and views for customization
- Executes custom Artisan commands after installation

---

📦 **Installation**
------------------

[](#-installation)

You can install the package via Composer:

```
composer require bijanbiria/laravel-deploy-wizard
```

---

🔧 **Configuration**
-------------------

[](#-configuration)

After installation, you may publish the configuration file to customize the route and final commands:

```
php artisan vendor:publish --tag=deploy-wizard-config
```

The configuration file will be published at: `config/deploywizard.php`

**Default Configuration:**

```
return [
    'route' => 'deploy-wizard',         // Route for accessing the wizard
    'complete_route' => 'home',         // Route to redirect after installation
    'final_commands' => [
        'php artisan route:cache',      // Cache application routes
        'php artisan migrate --force', // Run migrations
    ],
];
```

---

🗂️ **Publishing Views**
-----------------------

[](#️-publishing-views)

If you want to customize the look and feel of the installer, you can publish the views:

```
php artisan vendor:publish --tag=deploy-wizard-views
```

The views will be published to: `resources/views/vendor/deploy-wizard`

You can edit these Blade files to match your UI design.

---

🛠️ **Usage**
------------

[](#️-usage)

After installation, you can simply visit the route:

```
http://yourdomain.com/deploy-wizard

```

💡 **Note:** You don't even need to manually visit this page! If the `.env` file is missing and you try to access any route in your application, the wizard will automatically launch and redirect you to the deployment page to complete the setup.

If the `.env` file does not exist, it will be created automatically from `.env.example`. If `APP_KEY` is missing, a new key will be generated, and all migrations and seeders will be executed automatically.

The wizard is structured in 3 main steps:

1. **Step 1:** Application Configuration (App Name, URL, Environment)
2. **Step 2:** Locale Settings (Locale, Fallback Locale, Faker Locale)
3. **Step 3:** Database Configuration (DB Connection, Host, Port, Credentials)

At the end of Step 3, custom Artisan commands defined in the configuration will be executed.

---

⚙️ **Custom Route**
-------------------

[](#️-custom-route)

You can customize the route in the configuration file:

```
return [
    'route' => 'install-wizard' // Default is 'deploy-wizard'
];
```

Access it via:

```
http://yourdomain.com/install-wizard

```

---

✨ **Final Commands**
--------------------

[](#-final-commands)

You can define your own list of Artisan commands to be executed after the installation process. Simply update the `final_commands` array in `config/deploywizard.php`:

```
'final_commands' => [
    'php artisan storage:link',
    'php artisan migrate',
    'php artisan db:seed',
    'php artisan view:clear'
]
```

These commands will be executed sequentially once the wizard is complete.

---

🎓 **License**
-------------

[](#-license)

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

---

✨ **Contributing**
------------------

[](#-contributing)

Feel free to submit issues and pull requests. We are open to new ideas!

---

👤 **Author**
------------

[](#-author)

- **Bijan Biria** -

📰 **Article Link**
------------------

[](#-article-link)

- **bijanbiria.com** - [Laravel Deploy Wizard – Revolutionizing Laravel Installation](https://bijanbiria.com/laravel/laravel-deploy-wizard/)

###  Health Score

31

—

LowBetter than 66% of packages

Maintenance46

Moderate activity, may be stable

Popularity11

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

3

Last Release

410d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b0ff073a53127f9d63cb78451d0979c01a1953ac1adce12365cf2cddbb0e1437?d=identicon)[bijanbiria](/maintainers/bijanbiria)

---

Top Contributors

[![bijanbiria](https://avatars.githubusercontent.com/u/8328997?v=4)](https://github.com/bijanbiria "bijanbiria (18 commits)")

### Embed Badge

![Health badge](/badges/bijanbiria-laravel-deploy-wizard/health.svg)

```
[![Health](https://phpackages.com/badges/bijanbiria-laravel-deploy-wizard/health.svg)](https://phpackages.com/packages/bijanbiria-laravel-deploy-wizard)
```

###  Alternatives

[unopim/unopim

UnoPim Laravel PIM

10.3k2.2k](/packages/unopim-unopim)[statamic-rad-pack/runway

Eloquently manage your database models in Statamic.

135212.4k7](/packages/statamic-rad-pack-runway)[ecotone/laravel

Ecotone for Laravel — CQRS, Event Sourcing, Sagas, Durable Workflows, and Outbox on top of Laravel Queue, via PHP attributes.

21313.7k3](/packages/ecotone-laravel)[duncanmcclean/statamic-cargo

Comprehensive e-commerce addon for Statamic. Build bespoke e-commerce sites without the complexity.

3310.1k](/packages/duncanmcclean-statamic-cargo)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
