<div align="center">
	<p><img src="art/header.jpg" alt="PowerGrid Logo"></p>
    <p align="center">
        <a href="https://packagist.org/packages/power-components/livewire-powergrid"><img alt="Total Downloads" src="https://img.shields.io/packagist/dt/power-components/livewire-powergrid"></a>
        <a href="https://github.com/Power-Components/livewire-powergrid/actions">
            <img alt="Tests Passing" src="https://github.com/Power-Components/livewire-powergrid/workflows/Powergrid%20Tests/badge.svg" />
        </a>
        <a href="https://packagist.org/packages/power-components/livewire-powergrid"><img alt="Latest Version" src="https://img.shields.io/packagist/v/power-components/livewire-powergrid"></a>
        <a href="https://packagist.org/packages/power-components/livewire-powergrid"><img alt="License" src="https://img.shields.io/packagist/l/power-components/livewire-powergrid"></a>
    </p>
    <a href="https://livewire-powergrid.docsforge.com/" target="_blank">📚 Documentation</a> |
    <a href="#features">🔥 Features</a> |
    <a href="#get-started">⌨️ Get started</a>
</div>

------

# Livewire ⚡PowerGrid⚡

<br/>

PowerGrid creates modern, powerful and easy to customize Datatables based on Laravel [Livewire](https://laravel-livewire.com) library.

<br/>

➔  **Zero Configuration**: Tables have basic features activated by default.

➔  **It fits your needs**: Extend and customize your table including components (checkbox, action buttons, editable fields), global search feature, column data filters and data export tool.

➔  **Full Stubs**: Table components include feature examples. Just uncomment some code, enter your data, and it works!


<br/>

## 🚀 Instant Demo

Get a view of what PowerGrid can offer in just 2 commands:

Install

```bash
composer require power-components/livewire-powergrid
```

Run

```bash
php artisan powergrid:demo
```

<br/>

## Features

With PowerGrid you get right out of the box:

- **Filters & Search**

- **Column Sorting**

- **Pagination**

- **Action checkboxes**

- **Action buttons**

- **Toggle button**

- **Click to edit**

- **Click to copy**

- **Link inside a table cell**

- **Livewire Modal Integration ([Livewire UI](https://github.com/livewire-ui/modal))**

- **Data Export to XLSX/CSV ([Spout](https://github.com/box/spout))**

- **Queue Export for large tables**

- **Works with Bootstrap 5 or Tailwind CSS 2**

- **Translations available for 🇺🇸 🇧🇷 🇪🇸 🇮🇹 🇩🇪 and others...**

<br/>

 ![Laravel Livewire Tables](https://github.com/Power-Components/powergrid-doc/blob/main/doc/img/example.gif?raw=true)

------

# Get started

## 1. Requirements

- PHP 7.4.1+
- [Laravel 8x](https://laravel.com/docs/8.x/installation)
- [Livewire 2x](https://laravel-livewire.com)
- [Tailwind](https://tailwindcss.com/docs/guides/laravel) or [Bootstrap 5](https://getbootstrap.com/docs/5.0/getting-started/introduction/)

<br/>

## 2. Install

Please follow the steps indicated in our [Documentation - Install](https://livewire-powergrid.docsforge.com/main/install/) page.

<br/>

## 3. Support

For questions, issues, bug reports and feature requests, please use our [Issues](https://github.com/Power-Components/livewire-powergrid/issues).

Before submitting a new request, please look into our previous issues.

Verify if your bug/question or feature request has been previously submitted.

<br/>

## 4. How to contribute

🇺🇸 [How to contribute to PowerGrid](https://github.com/Power-Components/como-contribuir-com-o-powergrid/blob/main/README-EN.md) - Translation by [@DanSysAnalyst](https://github.com/DanSysAnalyst)

🇧🇷 [Guia para contribuir com o Powergrid](https://github.com/Power-Components/como-contribuir-com-o-powergrid/) - by [Claudio Pereira](https://github.com/cpereiraweb)

<br/>

## 5. Credits

Created by: [Luan Freitas](https://github.com/luanfreitasdev)

- [Contributors](../../contributors)
- Logo & artwork by [Caneco](https://github.com/caneco)

<br/>

## 6. Thanks  💓

- [JetBrains PhpStorm](https://www.jetbrains.com/phpstorm/) ([@phpstorm](https://twitter.com/phpstorm)) for sponsoring open-source development.
