Laravel Multi-Step Wizard Package (Headless)

Laravel Headless Wizard

Version v1.2.0 Tests Passing Coverage 89.7% PHPStan Level 5

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

🚀 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:

php artisan wizard:make Onboarding
# Interactive: Choose wizard type (Blade/API/Livewire/Inertia)

Add steps to your wizard:

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

📚 Documentation

Installation

Get started with Laravel Headless Wizard in minutes

Configuration

Configure storage, routes, and behavior

Creating Wizards

Learn how to create multi-step wizards

API Reference

Complete API documentation

Examples

Real-world usage examples

Testing

Test your wizard implementations

✨ Key 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

📊 Code Quality

  • 89.7% Test Coverage - 399 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

Contributions are welcome! Please see our Contributing Guide for details.

📝 License

The MIT License (MIT). Please see License File for more information.