README.md

Laravel Livewire

See the docs for everything: https://laravel-livewire.com/docs/quickstart

All contributions are welcomed! (but please submit an issue to make sure the PR is warranted first)

Open GitHub issues for all bugs. Ideas and questions belong on the forum or Discord server.

Contribute to the docs here: https://github.com/livewire/docs

Release Schedule

Livewire uses semantic versioning and will use the following release schedule strategy:

• Urgent bug fix? Release as "patch" version bump right away
• Patch? Group of small enhancements and bugfixes to be released every ~2 weeks-ish
• Minor? New features or significant API additions
• Major? Breaking changes and big strategy changes

Important Note: All "major" versions will be tagged alongside Laravel's major version release schedule (every 6 months). That does not mean Livewire will release a major version every 6 months, just that when it DOES release a major version, it will coincide with a Laravel release.

Roadmap

• Add a $formData magic property to pass into submit handler actions: wire:submit="save($formData)"
• Scope loading targets to actions WITH parameters: <div wire:loading wire:target="updateTodo({{ $todo->id }})">
• Remove wire:poll setIntervals an element is removed, or when the attribute is removed. #563
• Implement wire:model.passive
• Add wire:eval for latent script tag evaluation
• Add wire:append for appending DOM changes rather than replacing them
• Allow traits to hook into all lifecycle hooks

V2 Roadmap

• Change all in-code references of livewire to wire? @wire('foo'), artisan wire:make, <wire:foo>
• Change window.livewire to window.Livewire (And update Alpine to adapt)
• Make ->getName() in src/Component.php a static method
• Use camel-cased accessors for snake-cased properties ($this->foo_bar -> $this->getFooBarProperty) (PR ready here: #690)
• Maybe remove base render() method to allow for DI in method params (PR here: #893)

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Caleb Porzio 💻 ⚠️	Lance Pioch 💻 🚧	Tonko Mulder 📖	David Piesse 💻 📖 ⚠️	Melek REBAI 💻 🚧	Nuno Maduro 💻	Logan Henson 💻
Joris Kuijpers 💻	Andréas Lundgren 💻	Gal Jakič ⚠️ 🚧	Justin Seliga 💻	Francis Lavoie 💻	P. D. Devins 💻	Mateus Junges 💻
Mark Salmon 💻	Brian Faust 💻 ⚠️ 🚧	Intellow 💻 🚧 💵	Ahmet Bedir 💻	Jesse Leite 📖	Till Krüss 🚧 💻	Tom Westrick 💻
Gustavo Real 💻	Lasse Mettovaara 🚧	Lucas Michot 🚧 💻	Wisdom Anthony Ebong 💻	Frank Lakatos 🚧 💻	Roy Verrips 🚧	The Defenestrator 💻
Angus Allman 🚧	Chrysanthos 💻	ALMAS 💻	Austen Cameron 💻	Cihan Tas 💻	Ilya Sakovich 🚧 💻	Chin Leung 💻
Ricardo Gobbo de Souza 💻	lucasromanojf 💻	Taylor Otwell 💵 💻	Mo Khosh 💻	duccm 💻	Lars Erik Løvhaug 🚧	Harry Gulliford 🚧
Dries Vints 💻	Tor Morten Jensen 💻	Kevin Dion 🚧	Adrian Nürnberger 🚧 💻 ⚠️	Stefan Bauer 💻	Benjamin Beganović 🚧	Ruud Schuurmans 🚧
John Gile 💻 ⚠️ 🚧	Jason Beggs 🚧	Ramesh Mhetre 💻	Manojkiran Appathurai 💻	Steve Bauman 🚧	Tim 🚧	CS Rhymes 🚧 💻
Niels Peen 💻	Wojtek Mieszczak 🚧	Imran Bajerai 💻	Tom Janssen 💻	Dan Harrin 💻	Michael Bøcker-Larsen 🚧	DavideMoney 💻
Dennis van Dalen 💻	Cao Minh Duc 🚧	Ahmed Mohamed Abd El Ftah 💻	Eric Chow 💻	Muzaffer Dede 💻	Brent Vardy ⚠️

This project follows the all-contributors specification. Contributions of any kind welcome!

License

Copyright © Caleb Porzio

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