README

A lightweight, easy-to-use Laravel package for creating interactive data tables and dynamic forms with Livewire integration.

Overview

Laravel Simple Datatables And Forms provides two powerful components for your Laravel applications:

📊 Data Tables

Create interactive, feature-rich data tables with minimal code. Includes advanced search, sorting, filtering, grouping, and export capabilities.

📝 Dynamic Forms

Build dynamic forms with fluent API, multiple field types, validation, and model binding support.

Key Features

🔍 Advanced Search - Debounced search with minimum character requirements
🔄 Column Sorting - Click-to-sort functionality for table columns
🧹 Filtering & Grouping - Multiple filter types with advanced grouping options
📤 Data Export - Export to CSV, Excel, and PDF formats
📝 Dynamic Forms - Fluent features for building complex forms
🔧 Multiple Field Types - Input, Select, Checkbox, Toggle, Textarea, and more
✅ Validation Integration - Built-in Laravel validation support
📱 Responsive Design - Mobile-friendly components
⚡ Performance Optimized - Intelligent caching and query optimization
🔒 Security Features - CSRF protection and input sanitization
🧩 Seamless Livewire Integration - Built specifically for Livewire 3.x

Requirements

PHP 8.2 or higher (compatible with PHP 8.3 and 8.4)
Laravel 10.x or higher (compatible with Laravel 11.x and 12.x)
Livewire 3.x or higher

Quick Start

Installation

composer require milenmk/laravel-simple-datatables-and-forms

Publish Configurations

php artisan vendor:publish --tag=laravel-simple-datatables-and-forms-config

Publish Assets

php artisan simple-datatables-and-forms:publish-assets

Include Assets in Your Layout

<head>
    @SimpleDatatablesStyle
</head>
<body>
    <!-- Your content -->
    @SimpleDatatablesScript
</body>

Create Your First Data Table

Generate a table component:

php artisan make:milenmk-datatable UserList User --generate

Or create manually:

use Milenmk\LaravelSimpleDatatablesAndForms\Traits\HasTable;

class UserList extends Component
{
    use HasTable;

    public function table(Table $table): Table
    {
        return $table
            ->query(User::query())
            ->schema([
                TextColumn::make('name')->searchable()->sortable(),
                TextColumn::make('email')->searchable(),
                ToggleColumn::make('is_active')->label('Active'),
            ])
            ->striped()
            ->paginate();
    }
}

Create Your First Form

Generate a form component:

php artisan make:milenmk-form CreateUser create User --generate

Or create manually:

use Milenmk\LaravelSimpleDatatablesAndForms\Traits\HasForm;

class CreateUser extends Component
{
    use HasForm;

    public function form(Form $form): Form
    {
        return $form->model(User::class)->schema([
            InputField::make('name')->required(),
            InputField::make('email')->email()->required(),
            SelectField::make('role')
                ->options(['admin' => 'Admin', 'user' => 'User'])
                ->required(),
        ]);
    }
}

Documentation

📚 Complete Documentation

Documentation Hub - Complete documentation index and navigation guide
Troubleshooting Guide - Common issues and solutions

📊 Data Tables Documentation

Getting Started - Quick start guide for tables
Column Types - Complete reference for all column types
Configuration - Configuration guide and options
Advanced Features - Search, filtering, export, and caching

📝 Forms Documentation

Getting Started - Quick start guide for forms
Field Types - Complete reference for all field types
Validation - Validation rules and techniques
Advanced Features - Model binding and relationships

Tailwind CSS Integration

Add the package views to your Tailwind configuration:

// tailwind.config.js
module.exports = {
    content: [
        // ... your existing content paths
        './vendor/milenmk/laravel-simple-datatables-and-forms/resources/views/**/*.blade.php',
    ],
    // ... rest of your configuration
};

Contributing

Contributions are welcome! Please visit our GitHub repository to:

Report bugs or request features
Submit pull requests
Browse existing issues
Join discussions

Support

Documentation - Comprehensive guides and examples
GitHub Issues - Bug reports and feature requests
Email Support - Direct support for complex issues

License

This package is licensed under the MIT License. See the LICENSE file for more details.

Disclaimer

This package is provided "as is", without warranty of any kind. Please thoroughly test in your environment before deploying to production.

milenmk / laravel-simple-datatables-and-forms

Maintainers

Details