PHPackages                             invelity/laravel-headless-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. [API Development](/categories/api)
4. /
5. invelity/laravel-headless-wizard

ActiveLibrary[API Development](/categories/api)

invelity/laravel-headless-wizard
================================

Headless multi-step wizard package for Laravel with FormRequest validation, progress tracking, and frontend-agnostic API

v1.3.1(7mo ago)2171[1 issues](https://github.com/invelity/laravel-headless-wizard/issues)[6 PRs](https://github.com/invelity/laravel-headless-wizard/pulls)MITPHPPHP ^8.4CI passing

Since Nov 4Pushed 3mo agoCompare

[ Source](https://github.com/invelity/laravel-headless-wizard)[ Packagist](https://packagist.org/packages/invelity/laravel-headless-wizard)[ Docs](https://github.com/invelity/laravel-headless-wizard)[ GitHub Sponsors](https://github.com/WebSystem)[ RSS](/packages/invelity-laravel-headless-wizard/feed)WikiDiscussions main Synced today

READMEChangelog (5)Dependencies (14)Versions (15)Used By (0)

Laravel Headless Wizard
=======================

[](#laravel-headless-wizard)

[![Laravel Headless Wizard](featured.png)](featured.png)

[![Latest Version on Packagist](https://camo.githubusercontent.com/3f371228bab083cfba5168c21c2552e3a91703d7604b867fec8230eabf798757/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f696e76656c6974792f6c61726176656c2d686561646c6573732d77697a6172642e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/invelity/laravel-headless-wizard)[![GitHub Tests](https://camo.githubusercontent.com/49faa6e97e7648ff231aab8ed9de24a3e90a390b3736964a8d52873bf134cd59/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f696e76656c6974792f6c61726176656c2d686561646c6573732d77697a6172642f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/invelity/laravel-headless-wizard/actions)[![Total Downloads](https://camo.githubusercontent.com/6a91c83ded123eb857472e6be83827b5ebcd926c1d3e3e4bb55e3c23e659a081/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f696e76656c6974792f6c61726176656c2d686561646c6573732d77697a6172642e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/invelity/laravel-headless-wizard)[![Code Coverage](https://camo.githubusercontent.com/5bee31b408367217c65f257d45317fc185823e218ad9e0b8a62211a661219c84/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f636f7665726167652d39382e362532352d627269676874677265656e3f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/5bee31b408367217c65f257d45317fc185823e218ad9e0b8a62211a661219c84/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f636f7665726167652d39382e362532352d627269676874677265656e3f7374796c653d666c61742d737175617265)[![PHPStan](https://camo.githubusercontent.com/858ba49b4f650d5848b783ce7017c8872144428e62cd948e7b4d7bd815c8ffed/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d6c6576656c253230352d627269676874677265656e3f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/858ba49b4f650d5848b783ce7017c8872144428e62cd948e7b4d7bd815c8ffed/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d6c6576656c253230352d627269676874677265656e3f7374796c653d666c61742d737175617265)

A powerful **headless** multi-step wizard package for Laravel. Build complex, multi-page forms with progress tracking, navigation, and validation. **Bring your own frontend** - works with React, Vue, Inertia, Livewire, Alpine.js, or any JavaScript framework.

✨ Features
----------

[](#-features)

- 🚀 **Zero Frontend Lock-in** - Pure JSON API for any framework
- ⚡ **Interactive Generators** - Beautiful CLI with Laravel Prompts for wizard creation
- 🎨 **Pre-built Components** - Blade components for rapid prototyping (Layout, ProgressBar, Navigation)
- 🔄 **Vue 3 Composable** - useWizard() composable with TypeScript definitions for SPA integration
- 🔀 **Multi-Type Wizards** - Generate Blade, API, Livewire, or Inertia wizards
- ✅ **Laravel-Native Validation** - Uses FormRequest classes with automatic integration
- 💾 **Flexible Storage** - Session, database, or cache adapters
- 📊 **Smart Progress Tracking** - Real-time completion percentages with automatic calculation
- 🔀 **Conditional Logic** - Optional steps, dynamic flows, and step reordering
- 🔔 **Event-Driven** - Hook into every wizard lifecycle event
- ✨ **Modern PHP 8.4** - Property hooks, constructor promotion, and strict types

📚 Documentation
---------------

[](#-documentation)

**Full documentation available at: **

- [Installation Guide](https://invelity.github.io/laravel-headless-wizard/installation)
- [Configuration](https://invelity.github.io/laravel-headless-wizard/configuration)
- [Creating Wizards](https://invelity.github.io/laravel-headless-wizard/creating-wizards)
- [API Reference](https://invelity.github.io/laravel-headless-wizard/api-reference)
- [Examples](https://invelity.github.io/laravel-headless-wizard/examples)
- [Testing Guide](https://invelity.github.io/laravel-headless-wizard/testing)

🚀 Quick Start
-------------

[](#-quick-start)

Install the package:

```
composer require invelity/laravel-headless-wizard
```

Publish the configuration:

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

Create your first wizard (interactive):

```
php artisan wizard:make Onboarding
# Choose wizard type: blade, api, livewire, or inertia
```

Or with options:

```
php artisan wizard:make Onboarding --type=blade
```

Add steps to your wizard:

```
php artisan wizard:make-step Onboarding PersonalInfo --order=1
# Interactive prompts guide you through step creation
```

📋 Requirements
--------------

[](#-requirements)

- PHP 8.4 or higher
- Laravel 11.0 or 12.0

📊 Code Quality
--------------

[](#-code-quality)

- **89.7% Test Coverage** - 397 comprehensive Pest tests
- **Cyclomatic Complexity: 4.37** - Clean, maintainable code
- **PHPStan Level 5** - Zero static analysis errors
- **100% Type Coverage** - Full type declarations
- **Architecture Tests** - SOLID principles enforced via Pest Arch

🤝 Contributing
--------------

[](#-contributing)

Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.

🔒 Security
----------

[](#-security)

Report security vulnerabilities via [GitHub Security](../../security/policy).

📝 License
---------

[](#-license)

The MIT License (MIT). See [LICENSE.md](LICENSE.md) for details.

👨‍💻 Credits
-----------

[](#‍-credits)

- [Martin Halaj](https://github.com/Martin-1182)
- [All Contributors](../../contributors)

---

Built with ❤️ by [Invelity](https://github.com/invelity)

###  Health Score

39

—

LowBetter than 84% of packages

Maintenance64

Regular maintenance activity

Popularity10

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 91% 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 ~3 days

Total

5

Last Release

226d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/6db38c6ffc5415e6b7a6abd78a41f5036a4c52edb71d6aa344b267b7b834e562?d=identicon)[Martin1182](/maintainers/Martin1182)

---

Top Contributors

[![Martin-1182](https://avatars.githubusercontent.com/u/58297666?v=4)](https://github.com/Martin-1182 "Martin-1182 (61 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (5 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (1 commits)")

---

Tags

blade-componentsform-wizardheadlesslaravellaravel-packagelaravel-promptsmulti-step-formtypescriptvue3wizardapilaravelvalidationheadlesswizardmulti-step-formformrequestform-wizardInvelityprogress-tracker

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/invelity-laravel-headless-wizard/health.svg)

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

###  Alternatives

[dedoc/scramble

Automatic generation of API documentation for Laravel applications.

2.1k11.2M100](/packages/dedoc-scramble)[spatie/laravel-pdf

Create PDFs in Laravel apps

1.0k4.8M47](/packages/spatie-laravel-pdf)[defstudio/telegraph

A laravel facade to interact with Telegram Bots

816333.8k3](/packages/defstudio-telegraph)[rawilk/profile-filament-plugin

Profile &amp; MFA starter kit for filament.

3914.6k](/packages/rawilk-profile-filament-plugin)[simplestats-io/laravel-client

Server-side analytics for Laravel that follows the full funnel from visit to registration to payment, attributed to the channel that drove it. Revenue, MRR, churn and ad-spend profit (ROAS/CAC) per channel. GDPR compliant, ad-blocker proof.

5021.9k](/packages/simplestats-io-laravel-client)[lettermint/lettermint-laravel

Official Lettermint driver for Laravel

1190.2k1](/packages/lettermint-lettermint-laravel)

PHPackages © 2026

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