eramitgupta/laravel-Inertia-forms

Building forms with Laravel and a JavaScript frontend often means managing the same information in multiple places.

You define the fields in your frontend components, write validation rules in Laravel, handle errors, and keep everything in sync whenever something changes.

Laravel Inertia Forms takes a different approach.

You define your form in PHP, and the package takes care of rendering it in Vue, React, or Svelte. Your validation rules stay in Laravel, and the frontend handles displaying fields, errors, and user interactions.

This makes forms easier to build, update, and maintain, especially as your application grows.

• 🧩 Define forms in PHP — Keep your fields, layout, validation, and submit route together in one Laravel class.
• 📝 22 field types — Includes text, textarea, hidden, combobox, radio, checkbox, checkbox group, toggle, date, date range, time, color, slider, file upload, tags, key-value, repeater, blocks, link, slug, one-time code, chat composer, and submit buttons. You can also add headings, text, callouts, and separators.
• ⚡ Vue, React, and Svelte support — Use the same Laravel form definition with any of the three frontend frameworks.
• ✅ Laravel validation — Define rules directly on your fields using methods like required() and email(), and validate requests with #[Validate].
• 👁️ Conditional fields — Show or hide fields based on other values using visibleWhen() and hiddenWhen(). Conditions also apply during validation.
• 🔐 Field authorization — Control which fields users can access with authorizedWhen(). Unauthorized fields and their validation rules are excluded.
• 🔗 Model binding — Use ->bind($user) to populate forms from an existing model or array.
• 🪜 Multi-step forms — Build wizards with a stepper and server-side validation for each step.
• 📐 Flexible layouts — Organize forms using fieldsets, grid columns, legends, and icons.
• 🎯 Multiple form actions — Add submit buttons with different styles, sizes, icons, and intent() values. Use disableUntilDirty() when an action should only be available after changes.
• 🎨 200+ built-in icons — Use icons without installing a separate icon library. Only the SVG icons you use are sent to the frontend. Custom icons can be registered with Icon::register().
• 🧱 Custom fields — Create your own PHP field types and corresponding Vue, React, or Svelte components.
• 🌗 Accessible and customizable — Supports labels, ARIA attributes, focus handling, dark mode, accent colors, and Tailwind CSS 4.
• 🤖 Developer tools and AI support — Includes Artisan commands, Laravel Boost guidelines, and a skill to help AI coding agents work with the package.

First, install the Laravel package using Composer:

composer require erag/inertia-forms

Run the installation command:

php artisan erag:install-inertia-forms

Next, install the frontend package for the framework you're using.

Vue

npm install @erag/inertia-forms-vue

React

npm install @erag/inertia-forms-react

Svelte

npm install @erag/inertia-forms-svelte

You only need the frontend package for your chosen framework.

For setup instructions and usage examples, check the official documentation.

Laravel Inertia Forms connects your Laravel form definitions with frontend components.

The general workflow is simple:

1. Define your form in Laravel. Add the fields, validation rules, layout, and submission details in PHP.
2. Render it on the frontend. Use the <Form> component in Vue, React, or Svelte.
3. Handle user input. The frontend takes care of displaying the fields and handling interactions.
4. Validate with Laravel. Validation rules defined in your form are used when processing the request.
5. Display validation errors. The form can show errors returned from Laravel without manually rebuilding the validation logic.

You can also use the same form definition for editing existing records, conditional fields, and multi-step workflows.

The idea is to keep your form logic in one place while letting your frontend framework handle the user interface.

Not every form is a simple collection of text inputs.

Some forms need searchable dropdowns, file uploads, repeated groups of fields, or multiple steps.

Laravel Inertia Forms supports these use cases without requiring you to write a completely separate form system.

Use visibleWhen() and hiddenWhen() to control which fields appear based on the values entered by the user.

These conditions also affect validation, so hidden fields don't have to be handled separately.

Break longer forms into smaller steps using the built-in wizard support.

Each step can be validated on the server before moving forward.

When editing existing data, use ->bind($user) to populate the form from your model.

This allows you to reuse form definitions instead of maintaining separate structures for creating and editing records.

If the built-in fields don't cover your requirements, you can create custom field types and their frontend components.

This lets you extend the package while keeping the same form-building approach.

The documentation covers installation, form definitions, validation, conditional fields, authorization, layouts, custom components, and more.

Read the Official Documentation →

You can also explore the Live Demo to see the available fields and form features in action.

Want to see how Laravel Inertia Forms works in a real application?

I've created separate demo applications for Vue, React, and Svelte using Laravel 13 and Inertia 3.

Each demo includes 15 real-world forms with CRUD operations, search, file uploads, custom fields, and Pest tests.

You can clone a demo project, explore the implementation, and see how forms are organized in an actual Laravel application.

If Laravel Inertia Forms is useful in your project, consider giving the repository a star.

It helps other Laravel developers discover the package and supports its continued development.

⭐ Star Laravel Inertia Forms on GitHub

Laravel Inertia Forms is free and open source.

I maintain the package and work on improving its features, documentation, and developer experience.

If the package saves you time or makes your development workflow easier, you can support the project through GitHub Sponsors.

💖 Sponsor on GitHub

Your support helps me continue maintaining and improving this project for the Laravel community.