New

Just launched: Vueblocks, a brand-new search engine for Vue packages! Explore Vueblocks →

tranquil-tools/laravel-vue-form-builder

A VueJS/Inertia renderer for tranquil-tools/laravel-form-builder
2,132 1
Install
composer require tranquil-tools/laravel-vue-form-builder
Latest Version:1.21.0
PHP:^8.2
Laravel:11 · 12 · 13
License:MIT
Last Updated:Nov 13, 2026
Links: GitHub  ·  Packagist

A VueJS/Inertia FormBuilder package for Laravel

Define Laravel-VueJS forms configurations in PHP.

Documentation

Full documentation is available at docs.comfycoders.nl.

Topics covered:

Required fields

The label of every field whose rules contain required gets an asterisk, with a hidden "(required)" for screen readers. It is on by default; switch it off app-wide with 'required_indicator' => false in config/form-builder.php, and override a single field with ->markRequired() or ->markRequired(false). See Common options.

CrudBuilder

Want a complete CRUD solution? Our CrudBuilder builds on top of this FormBuilder and the TableBuilder to give you full create, read, update, and delete flows without repetitive boilerplate.

Installing the CrudBuilder pulls in this package automatically as a Composer dependency.


Quick start

Installation

You can install the package via composer:

composer require tranquil-tools/laravel-vue-form-builder

This is the Vue renderer; it depends on tranquil-tools/laravel-form-builder, the PHP core that defines the fields, validation and schema. One require pulls in both.

Install the frontend dependencies. The package ships raw .vue files that your application compiles, so their imports resolve against your node_modules. Beyond what the Laravel Vue starter kit already gives you:

npm install reka-ui @lucide/vue

A WYSIWYG editor is opt-in. The package imports no editor, so nothing is needed here unless you register one.

Optional: you may publish the config file with:

php artisan vendor:publish --tag="form-builder-config"

This creates config/form-builder.php, which ships with the PHP core.

Alter you vite.config.ts to add an @form-builder alias:

import {defineConfig} from 'vite';
import path from 'path';

export default defineConfig({
    plugins: [
        // ...
    ],
    resolve: {
        alias: {

            // Add this:

            '@form-builder': path.resolve(__dirname, 'vendor/tranquil-tools/laravel-vue-form-builder/resources/js'),
        },
    },
});

Basic usage

<?php

declare(strict_types=1);

namespace App\Http\Controllers;

use App\Forms\CategoryForm;
use App\Http\Requests\CategoryFormRequest;
use App\Models\ExampleModel;
use Inertia\Inertia;
use Inertia\Response;

class ExampleController extends Controller
{
    public function edit(ExampleModel $model): Response
    {
        return Inertia::render('PathToVueFile', [
            'form' => ExampleForm::make()
                ->action(route('categories.update', $model))
                ->method('PUT')
                ->fill($model),
        ]);
    }
}
<?php

declare(strict_types=1);

namespace App\Forms;

use App\Models\Template;
use TranquilTools\FormBuilder\AbstractForm;
use TranquilTools\FormBuilder\Fields\Number;
use TranquilTools\FormBuilder\Fields\Select;
use TranquilTools\FormBuilder\Fields\Submit;
use TranquilTools\FormBuilder\Fields\Text;
use TranquilTools\FormBuilder\Fields\Wysiwyg;
use TranquilTools\FormBuilder\FormConfig;

class ExampleForm extends AbstractForm
{
    public function configure(FormConfig $form)
    {
        $form->class(['space-y-4', 'mx-auto', 'mt-3']);
    }

    public function fields(): array
    {
        return [
            Number::make('position')
                ->label(__('Order'))
                ->rules([
                    'required',
                    'integer',
                    'min:1',
                ]),

            Text::make('title')
                ->label(__('Name'))
                ->autocomplete(false)
                ->rules([
                    'required',
                    'string',
                    'max:255',
                ]),

            Text::make('description')
                ->label(__('Description'))
                ->autocomplete(false)
                ->rules([
                    'required',
                    'string',
                    'max:255',
                ]),
                
            Wysiwyg::make('content')
                ->label(__('Content')),

            Select::make('template_id')
                ->label(__('Template'))
                ->options(Template::all()->pluck('name', 'id')->toArray())
                ->rules([
                    'nullable',
                    'exists:templates,id',
                ]),

            Submit::make()
                ->label(__('Save')),
        ];
    }
}
<?php

declare(strict_types=1);

namespace App\Http\Requests;

use App\Forms\ExampleForm;
use Illuminate\Foundation\Http\FormRequest;

class ExampleFormRequest extends FormRequest
{
    public function rules(): array
    {
        return ExampleForm::rules();
    }
}

A field takes classes in two places: ->wrapperClass() (or the older ->class()) replaces the classes of the wrapper around label, control and errors, and ->inputClass() adds classes to the input, select, checkbox or button itself. See Common options.


<script setup lang="ts">
    import Form from '@form-builder/components/Form.vue';
    import {FormSchema} from '@form-builder/types/form-builder';

    defineProps<{
        form: FormSchema;
    }>();
</script>

<template>
    <div class="...">
        <div class="...">
            <Form :schema="form"/>
        </div>
    </div>
</template>

Click and other event handlers are attached in Vue, never from PHP (->attributes(['@click' => ...]) throws). Pass them through fieldOverrides, and they land on the button or input itself:

<Form :schema="form" :field-overrides="{ preview: { onClick: () => (previewOpen = true) } }" />

See Click and other event handlers.

Related Packages

tranquil-tools/laravel-form-builder

Define Laravel form configurations in PHP: schema, fields, validation and config...

2,540 0
tranquil-tools/laravel-vue-table-builder

A VueJS/Inertia renderer for tranquil-tools/laravel-table-builder

2,014 0
tranquil-tools/laravel-table-builder

Define Laravel tables in PHP: columns, filters, search, sorting, bulk and row ac...

1,452 0
laravel/breeze

Minimal Laravel authentication scaffolding with Blade and Tailwind.

46,176,318 3,058

Version History

Version Released PHP Laravel License
1.21.0 ^8.2 ^11.0||^12.0||^13.0 MIT
1.20.0 ^8.2 ^11.0||^12.0||^13.0 MIT
1.19.0 ^8.2 ^11.0||^12.0||^13.0 MIT
1.18.0 ^8.2 ^11.0||^12.0||^13.0 MIT
1.17.0 ^8.2 ^11.0||^12.0||^13.0 MIT