PHPackages 3neti/form-flow - 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. [Utility & Helpers](/categories/utility) 4. / 5. 3neti/form-flow ActiveLibrary[Utility & Helpers](/categories/utility) 3neti/form-flow =============== Driver-based form flow orchestration system with DirXML-style mapping for Laravel applications v1.7.15(3mo ago)01.1k5MITPHPPHP ^8.2CI failing Since Dec 24Pushed 1mo agoCompare [ Source](https://github.com/3neti/form-flow)[ Packagist](https://packagist.org/packages/3neti/form-flow)[ Docs](https://github.com/3neti/form-flow)[ RSS](/packages/3neti-form-flow/feed)WikiDiscussions main Synced 3d ago READMEChangelog (1)Dependencies (12)Versions (24)Used By (5) Form Flow ========= [](#form-flow) [![Latest Version](https://camo.githubusercontent.com/2bc3a29d0f0689309030ed9666794ec2a479922926539ec2fe92aaaf57936c5f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f336e6574692f666f726d2d666c6f772e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/3neti/form-flow)[![Tests](https://camo.githubusercontent.com/919098a8853f8b3cff61fce0a0e39d962abcc6277f20529f17ae315054ec75e9/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f336e6574692f666f726d2d666c6f772f74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/3neti/form-flow/actions/workflows/tests.yml)[![Total Downloads](https://camo.githubusercontent.com/47d677b4c86ac09031e9412a7e7e85babf15a2c06eb30ec2addd9b5773d9f9a8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f336e6574692f666f726d2d666c6f772e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/3neti/form-flow)[![MIT Licensed](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE) Driver-based form flow orchestration system with DirXML-style mapping for Laravel applications. Features -------- [](#features) - **Driver-Based Architecture**: Define multi-step form flows using YAML configuration files - **DirXML-Style Mapping**: Transform and map data between steps using flexible mapping rules - **Handler Plugin System**: Extend functionality with custom form handlers - **Built-in Handlers**: FormHandler, SplashHandler, and MissingHandler included - **Vue Components**: Pre-built Inertia.js Vue components for rapid development - **Configurable**: Customize route prefixes, middleware, and behavior - **Self-Contained**: Automatic CSRF handling, route registration, and asset publishing Requirements ------------ [](#requirements) - PHP ^8.2 - Laravel ^11.0 || ^12.0 - Inertia.js ^2.0 Installation ------------ [](#installation) Install via Composer: ``` composer require 3neti/form-flow ``` ### Publish Assets [](#publish-assets) Publish the configuration file: ``` php artisan vendor:publish --tag=form-flow-config ``` Publish driver examples: ``` php artisan vendor:publish --tag=form-flow-drivers ``` Publish Vue components: ``` php artisan vendor:publish --tag=form-flow-views ``` Or publish everything at once: ``` php artisan vendor:publish --tag=form-flow-core ``` Configuration ------------- [](#configuration) The package configuration is located at `config/form-flow.php`: ``` return [ 'route_prefix' => env('FORM_FLOW_ROUTE_PREFIX', 'form-flow'), 'middleware' => ['web'], 'driver_directory' => config_path('form-flow-drivers'), 'session_prefix' => 'form_flow', 'handlers' => [ // Plugin handlers register themselves via service providers ], ]; ``` Usage ----- [](#usage) ### Creating a Form Flow [](#creating-a-form-flow) Define a flow driver in `config/form-flow-drivers/my-flow.yaml`: ``` name: my-flow title: My Form Flow steps: - handler: splash config: title: Welcome message: Let's get started - handler: form config: title: User Information fields: - name: full_name type: text label: Full Name validation: required|string|max:255 ``` ### Starting a Flow [](#starting-a-flow) ``` use Illuminate\Support\Facades\Http; $response = Http::post('/form-flow/start', [ 'reference_id' => 'unique-transaction-id', 'steps' => [ ['handler' => 'splash', 'config' => [...]], ['handler' => 'form', 'config' => [...]], ], 'callbacks' => [ 'on_complete' => 'https://your-app.com/api/flow-complete', 'on_cancel' => 'https://your-app.com/api/flow-cancelled', ], ]); $flowUrl = $response->json('flow_url'); ``` ### Available Routes [](#available-routes) The package automatically registers these routes: - `POST /form-flow/start` - Start a new flow - `GET /form-flow/{flow_id}` - Show current step - `POST /form-flow/{flow_id}/step/{step}` - Update step data - `POST /form-flow/{flow_id}/complete` - Complete flow - `POST /form-flow/{flow_id}/cancel` - Cancel flow - `DELETE /form-flow/{flow_id}` - Destroy flow state Plugin Development ------------------ [](#plugin-development) Create custom handlers by implementing `FormHandlerInterface`: ``` use LBHurtado\FormFlowManager\Contracts\FormHandlerInterface; class MyCustomHandler implements FormHandlerInterface { public function getName(): string { return 'my-custom'; } public function handle(Request $request, FormFlowStepData $step, array $context = []): array { // Process step data return ['processed' => true]; } public function render(FormFlowStepData $step, array $context = []) { return inertia('MyCustomView', [...]); } // ... other methods } ``` Register in your service provider: ``` public function boot(): void { $handlers = config('form-flow.handlers', []); $handlers['my-custom'] = MyCustomHandler::class; config(['form-flow.handlers' => $handlers]); } ``` Vue Components -------------- [](#vue-components) The package includes ready-to-use Vue components: - `GenericForm.vue` - Generic form renderer - `Splash.vue` - Splash screen handler - `Complete.vue` - Flow completion page - `MissingHandler.vue` - Fallback for missing handlers Testing ------- [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for recent changes. License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE) for more information. Credits ------- [](#credits) - [Lester Hurtado](https://github.com/lbhurtado) - [3neti](https://github.com/3neti) ### Health Score 44 — FairBetter than 90% of packages Maintenance85 Actively maintained with recent releases Popularity14 Limited adoption so far Community12 Small or concentrated contributor base Maturity57 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 ~4 days Total 23 Last Release 108d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/586e1ed70140038e6348728222adbcf68bfc4455b1f94a4f8bcbe57917a63d57?d=identicon)[3neti](/maintainers/3neti) --- Top Contributors [![3neti](https://avatars.githubusercontent.com/u/89447696?v=4)](https://github.com/3neti "3neti (28 commits)") --- Tags laravelmapperdriverinertiawizardvueform-flowmulti-step-formdirxml ### Code Quality TestsPest ### Embed Badge ![Health badge](/badges/3neti-form-flow/health.svg) ``` [![Health](https://phpackages.com/badges/3neti-form-flow/health.svg)](https://phpackages.com/packages/3neti-form-flow) ``` ### Alternatives [laravel/sail Docker files for running a basic Laravel application. 1.9k205.7M1.3k](/packages/laravel-sail)[craftcms/cms Craft CMS 3.6k3.6M3.1k](/packages/craftcms-cms)[psalm/plugin-laravel Psalm plugin for Laravel 3355.3M346](/packages/psalm-plugin-laravel)[emargareten/inertia-modal Inertia Modal is a Laravel package that lets you implement backend-driven modal dialogs for Inertia apps. 90142.9k](/packages/emargareten-inertia-modal) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)