包简介

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

README 文档

README

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

🚀 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

Full documentation available at: https://invelity.github.io/laravel-headless-wizard/

🚀 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

PHP 8.4 or higher
Laravel 11.0 or 12.0

📊 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

Contributions are welcome! Please see CONTRIBUTING.md for details.

🔒 Security

Report security vulnerabilities via GitHub Security.

📝 License

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

👨‍💻 Credits

Built with ❤️ by Invelity

invelity/laravel-headless-wizard 适用场景与选型建议

invelity/laravel-headless-wizard 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 17 次下载、GitHub Stars 达 2，最近一次更新时间为 2025 年 11 月 04 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「api」「wizard」「validation」「headless」「laravel」「formrequest」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 invelity/laravel-headless-wizard 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 invelity/laravel-headless-wizard 我们能提供哪些服务？

定制开发 / 二次开发

基于 invelity/laravel-headless-wizard 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 invelity/laravel-headless-wizard 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

mistralys/html_quickform2 2

Provides methods to create, validate and render HTML forms in PHP.

oktopuce/site-generator 5

Site generator / tree model duplicator used to generate mini-website or duplicate tree model

theodorejb/phaster 6

A PSR-7 compatible library for making CRUD API endpoints

patricksavalle/slim-request-params 9

Adds request-parameter validation to the SLIM 3.x PHP framework

stefangabos/zebra_form 96

A jQuery augmented PHP library for creating and validating HTML forms

coolanole/yii2-wizardwidget 0

Multi step wizard widget using tabs to guide a user through steps to complete a task. Based on the Form wizard (using tabs) from lukepzak (see http://bootsnipp.com/snippets/featured/form-wizard-using-tabs).

invelity/laravel-headless-wizard

包简介

关键字：