PHPackages                             artisanpack-ui/forms - 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. artisanpack-ui/forms

ActiveLibrary[Utility & Helpers](/categories/utility)

artisanpack-ui/forms
====================

A comprehensive form builder and management package for Laravel with drag-and-drop builder, submissions, notifications, file uploads, multi-step forms, conditional logic, and webhooks.

1.3.0(4w ago)2244GPL-3.0-or-laterPHPPHP ^8.2CI passing

Since Jan 7Pushed 4w agoCompare

[ Source](https://github.com/ArtisanPack-UI/forms)[ Packagist](https://packagist.org/packages/artisanpack-ui/forms)[ RSS](/packages/artisanpack-ui-forms/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (9)Dependencies (93)Versions (18)Used By (0)

ArtisanPack UI Forms
====================

[](#artisanpack-ui-forms)

ArtisanPack UI Forms is a comprehensive form builder and management package for Laravel applications. Built on Livewire 3, it provides a drag-and-drop form builder, submission management, email notifications, file uploads, multi-step forms, conditional logic, and webhook integrations.

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

[](#-quick-start)

### Installation

[](#installation)

```
# Install the package
composer require artisanpack-ui/forms

# Publish configuration and assets
php artisan vendor:publish --provider="ArtisanPackUI\Forms\FormsServiceProvider"

# Run migrations
php artisan migrate
```

### Basic Usage

[](#basic-usage)

```

```

✨ Key Features
--------------

[](#-key-features)

- **🎨 Visual Form Builder**: Drag-and-drop interface for creating forms without code
- **📝 20+ Field Types**: Text, email, textarea, select, checkbox, radio, file upload, date, time, and more
- **📊 Submission Management**: View, export, and manage form submissions with ease
- **📧 Email Notifications**: Admin notifications and autoresponders with template support
- **📁 Secure File Uploads**: Private file storage with MIME validation and size limits
- **📑 Multi-Step Forms**: Create wizard-style forms with step navigation
- **🔀 Conditional Logic**: Show/hide fields and steps based on user input
- **🔗 Webhook Integration**: Send form data to external services with HMAC signatures
- **🛡️ Spam Protection**: Built-in honeypot fields and rate limiting
- **🔒 Authorization**: Policy-based access control with ownership support
- **📤 Export Options**: Export submissions to CSV format

🧩 Components
------------

[](#-components)

### Livewire Components

[](#livewire-components)

ComponentDescription`FormBuilder`Visual drag-and-drop form builder interface`FormRenderer`Renders forms for user submission`FormsList`Lists and manages forms`SubmissionsList`Lists and manages submissions`SubmissionDetail`Displays submission details`NotificationEditor`Configure email notifications### Available Field Types

[](#available-field-types)

**Basic Fields**: Text, Email, URL, Phone, Number, Password, Hidden

**Text Fields**: Textarea, Rich Text Editor

**Selection Fields**: Select, Multi-Select, Checkbox, Radio, Toggle

**Date/Time Fields**: Date, Time, DateTime

**File Fields**: File Upload, Multiple Files

**Layout Fields**: Heading, Paragraph, Divider

📖 Documentation
---------------

[](#-documentation)

Comprehensive documentation is available in our [Documentation Wiki](https://github.com/ArtisanPack-UI/forms/wiki):

- **[Installation Guide](https://github.com/ArtisanPack-UI/forms/wiki/Installation-Installation)** - Detailed setup instructions
- **[Configuration](https://github.com/ArtisanPack-UI/forms/wiki/Installation-Configuration)** - All configuration options
- **[Form Builder](https://github.com/ArtisanPack-UI/forms/wiki/Usage-Form-Builder)** - Creating forms
- **[Form Renderer](https://github.com/ArtisanPack-UI/forms/wiki/Usage-Form-Renderer)** - Displaying forms
- **[API Reference](https://github.com/ArtisanPack-UI/forms/wiki/Api)** - Models, services, and events

⚙️ Configuration
----------------

[](#️-configuration)

Publish the configuration file:

```
php artisan vendor:publish --tag=forms-config
```

### Environment Variables

[](#environment-variables)

The package supports the following environment variables:

VariableDescriptionDefault`FORMS_ADMIN_PREFIX`URL prefix for admin routes`admin/forms``FORMS_UPLOADS_DISK`Storage disk for file uploads`form-uploads``FORMS_UPLOADS_MAX_SIZE`Maximum file size in KB`10240` (10MB)`FORMS_RETENTION_DAYS`Days to keep submissions (null = forever)`null``FORMS_HONEYPOT_ENABLED`Enable honeypot spam protection`true``FORMS_RATE_LIMIT_ENABLED`Enable rate limiting`true``FORMS_RATE_LIMIT_MAX`Maximum submissions per minute`5``FORMS_WEBHOOKS_ENABLED`Enable webhook integrations`true``FORMS_RESTRICT_BY_OWNER`Restrict forms to their owners`false``FORMS_ADMIN_BYPASS`Allow admins to bypass ownership`true``FORMS_USER_MODEL`User model class`App\Models\User`### Configuration Options

[](#configuration-options)

Key configuration options in `config/artisanpack/forms.php`:

```
return [
    // Admin panel settings
    'admin' => [
        'prefix' => 'admin/forms',
        'middleware' => ['web', 'auth'],
    ],

    // File upload settings
    'uploads' => [
        'disk' => 'form-uploads',
        'max_size' => 10240, // 10MB in KB
        'allowed_mimes' => ['image/jpeg', 'image/png', 'application/pdf'],
    ],

    // Submission settings
    'submissions' => [
        'store_submissions' => true,
        'retention_days' => null, // null = keep forever
    ],

    // Spam protection
    'spam_protection' => [
        'honeypot' => ['enabled' => true],
        'rate_limit' => ['enabled' => true, 'max_attempts' => 5],
    ],
];
```

🔧 Artisan Commands
------------------

[](#-artisan-commands)

```
# Prune old submissions based on retention settings
php artisan forms:prune-submissions

# Prune submissions older than specific days
php artisan forms:prune-submissions --days=90
```

📦 Requirements
--------------

[](#-requirements)

- PHP 8.2 or higher
- Laravel 11, 12, or 13 (Laravel 13 requires PHP 8.3+)
- Livewire 3.6+

🤝 Dependencies
--------------

[](#-dependencies)

This package integrates with the ArtisanPack UI ecosystem:

- [artisanpack-ui/livewire-ui-components](https://github.com/ArtisanPack-UI/livewire-ui-components) - UI components
- [artisanpack-ui/security](https://github.com/ArtisanPack-UI/security) - Input sanitization and security
- [artisanpack-ui/accessibility](https://github.com/ArtisanPack-UI/accessibility) - Accessibility utilities
- [artisanpack-ui/hooks](https://github.com/ArtisanPack-UI/hooks) - WordPress-style hooks for extensibility

🎯 Events
--------

[](#-events)

The package dispatches events for key actions:

```
use ArtisanPackUI\Forms\Events\FormCreated;
use ArtisanPackUI\Forms\Events\FormSubmitted;
use ArtisanPackUI\Forms\Events\SubmissionDeleted;

// Listen for form submissions
Event::listen(FormSubmitted::class, function ($event) {
    // $event->submission contains the submission
    // $event->form contains the form
});
```

🤖 AI features
-------------

[](#-ai-features)

The Forms package ships four opt-in AI agents that plug into the [artisanpack-ui/ai](https://github.com/ArtisanPack-UI/ai) feature registry. Install `artisanpack-ui/ai` (v1.0+) and configure credentials to enable them; each feature no-ops when its toggle is off, so upgrades are non-breaking.

Feature keyAgentDefault modelWhat it does`forms.spam_detection``SpamDetectionAgent``claude-haiku-4-5`Score a single submission for spam. Returns `spam_score`, `verdict`, and `reasons`.`forms.submission_summary``SubmissionSummaryAgent``claude-sonnet-4-6`Periodic digest of submission themes, notable entries, and suggested follow-ups.`forms.response_classification``ResponseClassificationAgent``claude-haiku-4-5`Categorize a submission against a caller-supplied set of labels; may propose a new one.`forms.smart_validation``SmartFieldValidationAgent``claude-haiku-4-5`Opt-in per-field semantic plausibility check that complements format validation.Each agent is invoked the same way — construct it with `for()` and call `run()`:

```
use ArtisanPackUI\Forms\Ai\Agents\SpamDetectionAgent;

$result = SpamDetectionAgent::for([
    'fields' => $submission->data_array,
    'meta'   => [
        'ip_country'          => $submission->ip_country,
        'submission_speed_ms' => $submission->submission_speed_ms,
    ],
])->run();
// [ 'spam_score' => int, 'verdict' => 'ham'|'suspicious'|'spam', 'reasons' => string[] ]
```

Each feature also ships a Livewire trigger component you can drop into the admin surface. Components no-op when the feature toggle is off:

```

```

See the [AI RFC](https://github.com/ArtisanPack-UI/.github/discussions/8) for the shared registry, toggle, and credential story across ArtisanPack UI packages.

🔌 Extensibility
---------------

[](#-extensibility)

Add custom field types using filter hooks:

```
use function addFilter;

addFilter('ap.forms.fieldTypes', function (array $types) {
    $types['my-custom-field'] = [
        'label' => 'My Custom Field',
        'view' => 'my-package::fields.custom',
        'settings' => ['option1', 'option2'],
    ];
    return $types;
});
```

### Hook naming

[](#hook-naming)

All package hooks use the `ap.forms.*` camelCase convention shared across the ArtisanPack UI ecosystem. Hooks previously shipped under `forms.*` / snake\_case names remain registered as deprecation aliases (via `Support\HookAliases`), so existing subscribers keep firing but emit an info-level deprecation log. The aliases will be removed in the next major version — migrate to the new names listed below.

Old (deprecated)New (canonical)`forms.field_types``ap.forms.fieldTypes``forms.field_categories``ap.forms.fieldCategories``forms.validation_rules``ap.forms.validationRules``forms.form.created``ap.forms.form.created``forms.form.updated``ap.forms.form.updated``forms.form.deleted``ap.forms.form.deleted``forms.submission.created``ap.forms.submission.created``forms.submission.updated``ap.forms.submission.updated``forms.submission.deleted``ap.forms.submission.deleted``forms.webhook_payload``ap.forms.webhookPayload``forms.settings_tabs``ap.forms.settingsTabs``forms.submission_data``ap.forms.submissionData``forms.export_headers``ap.forms.exportHeaders``forms.export_data``ap.forms.exportData``forms.notification_recipients``ap.forms.notificationRecipients``forms.notification.before_send``ap.forms.notification.beforeSend``forms.notification.sent``ap.forms.notification.sent``forms.notification_message``ap.forms.notificationMessage`### Additional hooks

[](#additional-hooks)

The following hooks have no legacy alias — they were introduced under the canonical `ap.forms.*` convention.

HookTypePayload`ap.forms.beforeValidate`action`(FormRequest $request)``ap.forms.validated`action`(FormRequest $request, array $validated)``ap.forms.fieldRender`filter`(string $html, FormField $field)``ap.forms.integrationRegistered`action`(string $slug, array $config)``ap.forms.notificationSubject`filter`(string $subject, FormNotification $notification, FormSubmission $submission)``ap.forms.notificationBody`filter`(string $body, FormNotification $notification, FormSubmission $submission)`Examples:

```
use ArtisanPackUI\Forms\Services\IntegrationService;
use function addAction;
use function addFilter;

// Wrap every rendered field in a diagnostic marker
addFilter('ap.forms.fieldRender', function (string $html, $field): string {
    return '' . $html . '';
});

// Observe integration registration from a third-party package
addAction('ap.forms.integrationRegistered', function (string $slug, array $config): void {
    logger()->info("forms integration registered: {$slug}", $config);
});

// Register your own integration from your service provider boot()
app(IntegrationService::class)->registerIntegration('mailchimp', [
    'label' => 'Mailchimp',
    'icon'  => 'o-envelope',
]);
```

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

[](#-contributing)

Contributions are welcome! To contribute:

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Merge Request

Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct and the process for submitting merge requests.

📄 License
---------

[](#-license)

ArtisanPack UI Forms is open-sourced software licensed under the [GPL-3.0-or-later license](LICENSE).

###  Health Score

47

—

FairBetter than 93% of packages

Maintenance94

Actively maintained with recent releases

Popularity19

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity56

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 ~24 days

Recently: every ~14 days

Total

9

Last Release

29d ago

### Community

Maintainers

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

---

Top Contributors

[![ViewFromTheBox](https://avatars.githubusercontent.com/u/8247489?v=4)](https://github.com/ViewFromTheBox "ViewFromTheBox (103 commits)")

---

Tags

form-builderform-validationformslaravellaravel-packagelivewirephp

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/artisanpack-ui-forms/health.svg)

```
[![Health](https://phpackages.com/badges/artisanpack-ui-forms/health.svg)](https://phpackages.com/packages/artisanpack-ui-forms)
```

###  Alternatives

[tallstackui/tallstackui

TallStackUI is a powerful suite of Blade components that elevate your workflow of Livewire applications.

731189.9k16](/packages/tallstackui-tallstackui)[livewire/flux

The official UI component library for Livewire.

9628.9M155](/packages/livewire-flux)[tomshaw/electricgrid

A feature-rich Livewire package designed for projects that require dynamic, interactive data tables.

119.8k](/packages/tomshaw-electricgrid)[venturedrake/laravel-crm

A free open source CRM built as a package for laravel projects

45212.2k1](/packages/venturedrake-laravel-crm)[noerd/noerd

111.6k17](/packages/noerd-noerd)

PHPackages © 2026

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