Livewire Volt

Volt is a functional, single-file component API layered on top of Laravel Livewire, letting a component’s PHP state/behavior and its Blade markup live in the same file instead of being split across a class and a separate template. Components are authored as plain functions/closures (state(), mount(), computed properties via computed(), and action closures) that Volt compiles down to standard Livewire component classes at runtime, so the resulting components behave identically to hand-written class-based Livewire components.

Because Volt compiles to real Livewire classes, it inherits Livewire’s full feature set — reactivity, wire:model binding, lifecycle hooks, validation — while trimming the boilerplate of maintaining a matching class file and view file for small, self-contained components.

What You Get

• A functional API (state(), mount(), computed(), rules(), action closures) for defining Livewire component behavior inline
• A compiler that transforms single-file components into standard Livewire component classes at runtime, with caching
• Full compatibility with existing Livewire features (reactivity, validation, lifecycle hooks, wire:model)
• Support for both anonymous (route-registered) and named single-file components
• Class-based single-file component support via PHP attributes for teams preferring class syntax with inline templates
• Console commands for making and listing Volt components

Common Use Cases

• Building small, page-specific interactive components without maintaining separate class/view files
• Rapidly prototyping Livewire UI logic co-located with its template for faster iteration
• Writing form or filter components where state and markup are tightly coupled and rarely reused elsewhere
• Migrating simple Blade views to reactive Livewire components with minimal added file structure

Under The Hood

Architecture — Volt’s Compiler.php and src/Compilers directory parse a single-file component’s PHP block (state/action definitions) and Blade template, then use ComponentFactory.php/ComponentResolver.php to generate an in-memory Livewire component class conforming to Livewire’s Component contract; MountedDirectory.php/MountedDirectories.php handle registering directories of single-file components as routable pages. LivewireManager.php/VoltManager.php hook into Livewire’s own component resolution so compiled Volt components are indistinguishable from hand-written ones at runtime. Tech Stack — PHP built directly against livewire/livewire, using Laravel’s service container and Blade compiler pipeline; ships resources/boost supporting Laravel Boost tooling. Code Quality — Tests are organized under tests/Unit and tests/Feature using Pest (tests/.pest), with a tests/Fixtures directory of sample single-file components used to validate compilation output, plus a workbench/ Laravel app for integration testing — though GitHub activity data shows low recent commit velocity, suggesting the package has reached feature stability rather than active churn. API Design — The functional API (state, computed, mount, inline action closures) mirrors patterns familiar from Vue/React composables, which lowers the learning curve for developers coming from JS component models, at the cost of an extra compilation step that’s largely invisible until debugging is needed.