Livewire

<p align="center"><img width="300" src="/art/logo.svg" alt="Livewire Logo"></p> <p align="center"> <a href="https://packagist.org/packages/livewire/livewire"> <img src="https://poser.pugx.org/livewire/livewire/d/total.svg" alt="Total Downloads"> </a> <a href="https://packagist.org/packages/livewire/livewire"> <img src="https://poser.pugx.org/livewire/livewire/v/stable.svg" alt="Latest Stable Version"> </a> <a href="https://packagist.org/packages/livewire/livewire"> <img src="https://poser.pugx.org/livewire/livewire/license.svg" alt="License"> </a> </p>

Introduction

Livewire is a full-stack framework for Laravel that allows you to build dynamic UI components without leaving PHP.

Official Documentation

You can read the official documentation on the Livewire website.

Local Development

git clone git@github.com:livewire/livewire.git && cd livewire
composer setup

This installs PHP and JS dependencies and sets up ChromeDriver for browser tests.

composer test:unit                                   # unit tests
composer test:browser                                # browser tests (headless)
composer test:browser:headed                         # browser tests (opens Chrome)
composer test:browser -- --filter="SupportCSP"       # specific tests

To build the JS assets after making changes: npm run build

Contributing

<a name="contributing"></a>

Thank you for considering contributing to Livewire! You can read the contribution guide here.

Code of Conduct

<a name="code-of-conduct"></a>

In order to ensure that the Laravel community is welcoming to all, please review and abide by Laravel's Code of Conduct.

Security Vulnerabilities

<a name="security-vulnerabilities"></a>

Please review our security policy on how to report security vulnerabilities.

License

<a name="license"></a>

Livewire is open-sourced software licensed under the MIT license.