eii / arqon-forms
A dynamic form builder and submission manager for Laravel 13 and Filament 5.
Requires
- php: ^8.3
- filament/filament: ^5.0
- illuminate/contracts: ^13.0
- illuminate/database: ^13.0
- illuminate/http: ^13.0
- illuminate/mail: ^13.0
- illuminate/routing: ^13.0
- illuminate/support: ^13.0
- illuminate/validation: ^13.0
- illuminate/view: ^13.0
- livewire/livewire: ^4.0
Requires (Dev)
- laravel/pint: ^1.0
- orchestra/testbench: ^11.0
- phpunit/phpunit: ^12.0
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
A lightweight, modern dynamic form builder and submission manager for Laravel 13 and Filament 5.
Package: eii/arqon-forms
Publisher: Eii Tech Solutions
Features
- Filament 5 Form Management: Intuitive builder resource for managing dynamic forms.
- In-Panel Modal Preview: Instant preview of forms inside a Filament modal with zero tab switching or URL redirects.
- Tailwind CSS v4 Powered: Beautiful, responsive UI compiled with Tailwind CSS v4 and zero CSS reset bleed into Filament.
- Light & Dark Mode: Native dark mode styling that automatically synchronizes with Filament's theme.
- Reorderable JSON Field Builder: Store flexible form schemas that adapt easily without schema migrations.
- Livewire-Powered Forms: Reactive input handling, honeypot protection, and instant validation.
- Reusable Blade Component: Easily embed any form with
<x-arqon-form slug="contact-us" />. - Public & Standalone Pages: Render public form endpoints at
/forms/{slug}standalone or embedded in your app layout. - Native Submissions Management: View and manage responses using Filament Infolists and structured data snapshots.
- Rate Limiting & Security: Built-in per-IP rate limiting, honeypot field, and HMAC IP address hashing.
- Email Notifications: Configurable submission alerts delivered synchronously or via queued background jobs.
Requirements
- PHP: 8.3+
- Laravel: 13.x
- Filament: 5.x
- Livewire: 4.x
Installation
Install the package via Composer:
composer require eii/arqon-forms:^1.0
Publish the package configuration:
php artisan vendor:publish --tag=arqon-forms-config
Run the database migrations:
php artisan migrate
Register the plugin in your Filament panel provider (usually app/Providers/Filament/AdminPanelProvider.php):
use Arqon\Forms\Filament\ArqonFormsPlugin; public function panel(Panel $panel): Panel { return $panel // ...your existing panel configuration ->plugins([ ArqonFormsPlugin::make(), ]); }
Creating & Publishing Forms
- Navigate to Forms → Forms in your Filament panel.
- Click New Form and add your fields using the visual builder.
- Use clean snake_case field identifiers (e.g.,
full_name,company_email). - Set the form status to Published, then save.
- Your form is now accessible via
/forms/{slug}or ready to embed in any page.
Form Preview
Arqon Forms includes an In-Panel Modal Preview:
- Clicking Preview on the edit page opens a modal showing the live form.
- Published forms have an Open public form action in the forms table.
- The preview runs the real Livewire component with submissions disabled to prevent test pollution.
- The modal matches your Filament panel theme with zero style bleed, honoring light and dark mode automatically.
- Optional temporary signed preview URLs (
/forms/_preview/{id}) remain available for external reviewers if enabled in config.
Embedding in Blade Templates
Embed any published form anywhere in your Laravel templates using the custom Blade component:
<x-arqon-form slug="contact-us" />
Ensure Livewire scripts and styles are present in your layout (@livewireStyles / @livewireScripts).
Rendering Inside Your Website Layout
By default, /forms/{slug} renders using an internal, self-contained standalone layout with precompiled Tailwind CSS.
To render public forms inside your website's main layout, configure render.layout and render.section in config/arqon-forms.php:
'render' => [ 'layout' => 'layouts.app', 'section' => 'content', ],
When a custom layout is configured, the form seamlessly adopts your application shell while maintaining its own input styling.
Supported Field Types
| Field Type | Key | Description |
|---|---|---|
| Short answer | text |
Single-line text input |
| Paragraph | textarea |
Multi-line text input |
email |
Email validation | |
| Number | number |
Numeric input |
| Phone | tel |
Telephone input |
| Website URL | url |
Web link validation |
| Dropdown | select |
Single selection dropdown with custom options |
| Single choice | radio |
Radio button list |
| Multiple choice | checkbox |
Multi-select checkboxes |
| Date | date |
HTML5 date picker |
| Yes / No | toggle |
Toggle / boolean checkbox |
| Hidden | hidden |
Stored form payload without respondent interaction |
Customizing Views
To customize the frontend templates, publish the package views:
php artisan vendor:publish --tag=arqon-forms-views
To keep your project clean, this publishes only the essential templates:
resources/views/vendor/arqon-forms/livewire/public-form.blade.php: The interactive form inputs, submit button, and error states.resources/views/vendor/arqon-forms/public.blade.php: The public form wrapper page (card container, headers, and footers).resources/views/vendor/arqon-forms/emails/submission-notification.blade.php: Email notification template.
Styling & Asset Building
Arqon Forms uses Tailwind CSS v4 with a CSS-first setup in resources/css/arqon-forms.css:
# Build minified CSS for distribution npm run build # Watch for CSS and template changes during development npm run dev
The compiled styles are placed in dist/arqon-forms.css and are automatically embedded in standalone and preview layouts without requiring separate asset publishing.
Configuration Reference
Key settings in config/arqon-forms.php:
| Setting | Default | Description |
|---|---|---|
route.prefix |
'forms' |
URL prefix for public form endpoints |
route.middleware |
['web'] |
Middleware applied to form routes |
preview.enabled |
true |
Enables temporary signed preview endpoints |
preview.allow_submissions |
false |
Whether submissions are allowed during preview |
submission.rate_limit.max_attempts |
5 |
Maximum attempts per IP per decay window |
submission.rate_limit.decay_minutes |
1 |
Decay window in minutes for rate limiting |
submission.store_ip_hash |
true |
Store salted HMAC IP hashes rather than raw IPs |
notifications.delivery |
'sync' |
Deliver notification emails via 'sync' or 'queue' |
For production, set a dedicated IP hash secret in .env:
ARQON_FORMS_IP_HASH_KEY="a-long-random-secret-value"
To queue notifications asynchronously:
ARQON_FORMS_NOTIFICATION_DELIVERY=queue
Queued notifications use Laravel's configured default queue connection and queue.
Testing
Run the test suite:
composer test
Code formatting:
composer format
License
MIT. See LICENSE.
