<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](https://livewire.laravel.com/docs).

## Local Development

```bash
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.

```bash
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](.github/CONTRIBUTING.md).

## 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](https://laravel.com/docs/contributions#code-of-conduct).

## Security Vulnerabilities
<a name="security-vulnerabilities"></a>

Please review [our security policy](https://github.com/livewire/livewire/security/policy) on how to report security vulnerabilities.

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

Livewire is open-sourced software licensed under the [MIT license](LICENSE.md).
