README

╔═══════════════════════════════════════════════════════════════╗
║                                                               ║
║   ███████╗ ██████╗ ██████╗ ███╗   ███╗ ██████╗██████╗  █████╗ ║
║   ██╔════╝██╔═══██╗██╔══██╗████╗ ████║██╔════╝██╔══██╗██╔══██╗║
║   █████╗  ██║   ██║██████╔╝██╔████╔██║██║     ██████╔╝███████║║
║   ██╔══╝  ██║   ██║██╔══██╗██║╚██╔╝██║██║     ██╔══██╗██╔══██║║
║   ██║     ╚██████╔╝██║  ██║██║ ╚═╝ ██║╚██████╗██║  ██║██║  ██║║
║   ╚═╝      ╚═════╝ ╚═╝  ╚═╝╚═╝     ╚═╝ ╚═════╝╚═╝  ╚═╝╚═╝  ╚═╝║
║                                                               ║
║            HTML & Form Builder for Laravel                    ║
║       🎨 50+ Components | 🚀 Modern | ♿ Accessible          ║
║                                                               ║
╚═══════════════════════════════════════════════════════════════╝

FormCraft - Laravel HTML & Form Builder

A comprehensive HTML and Form Builder for Laravel with 50+ modern features, strict PHP 8.2+ typing, and built-in support for Bootstrap & Tailwind CSS.

✨ Features

🎨 Theme Support - Bootstrap & Tailwind CSS
🔄 Livewire Compatible - Built-in wire:model helpers
♿ Accessibility Ready - Automatic ARIA attributes
📱 Responsive - Mobile-first design
🚀 50+ Components - Forms, UI elements, utilities
🎯 Zero Dependencies - No external JavaScript required

📦 Installation

composer require skywalker-labs/formcraft

Publish configuration:

php artisan vendor:publish --tag=html-config

🚀 Quick Start

Basic Form

{!! Form::open(['url' => 'users/store']) !!}
    {!! Form::text('name') !!}
    {!! Form::email('email') !!}
    {!! Form::submit('Save') !!}
{!! Form::close() !!}

Model Binding

{!! Form::model($user, ['route' => ['users.update', $user]]) !!}
    {!! Form::text('name') !!}
    {!! Form::email('email') !!}
    {!! Form::submit('Update') !!}
{!! Form::close() !!}

Blade Components

<x-form-input name="email" label="Email" />
<x-form-select name="country" :options="$countries" />
<x-form-textarea name="bio" rows="5" />
<x-form-checkbox name="agree" label="I agree" />

📚 Key Features

HTML5 Validation Rules

{!! Form::rules('required|email|max:255')->text('email') !!}
{!! Form::rules('required|min:8')->password('password') !!}

Smart Components

// Toggle switch
{!! Form::toggle('notifications', 1, true, ['label' => 'Enable']) !!}

// Color picker
{!! Form::colorPicker('theme_color', '#3490dc') !!}

// Searchable select
{!! Form::searchableSelect('country', $countries) !!}

// Date picker
{!! Form::datePicker('birthday') !!}

// File upload with preview
{!! Form::fileUpload('avatar', ['preview' => true]) !!}

Livewire Integration

{!! Form::wire('email')->text('email') !!}
{!! Form::wireLive('search', 300)->text('search') !!}
{!! Form::wireClick('save')->submit('Save') !!}

UI Components

{!! Html::alert('Success!', 'success') !!}
{!! Html::progressBar(75, ['striped' => true]) !!}
{!! Html::badge('New', 'primary') !!}
{!! Html::tabs(['Tab 1' => 'Content 1', 'Tab 2' => 'Content 2']) !!}

📖 Documentation

Complete documentation available in the repository:

🎯 Feature List

Phase 1-4: Core features, utilities, UI components, Livewire
Phase 5: Validation rules, toggles, color pickers, ratings
Phase 6: Searchable/multi/AJAX selects, autocomplete
Phase 7: Date/time pickers, file uploads
Phase 8: Rich text editor, inline editing, form wizards
Phase 9: Progress bars, badges, tabs, accordion, tooltips

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

The Laravel HTML package is open-sourced software licensed under the MIT license.

skywalker-labs / formcraft

Maintainers

Details