Skip to content

Volt components do not support namespacing, causing conflicts across modules with same component names #137

@eliofery

Description

@eliofery

Volt Version

1.7

Laravel Version

12

PHP Version

8.4

Database Driver & Version

No response

Description

In my Laravel project, I follow a modular structure where each module can have its own set of Livewire components. It’s common for different modules to have components with the same name (e.g., Button), and Livewire allows for namespacing to prevent conflicts:

class Button extends Component
{
    public function render()
    {
        return view('somemodule::livewire.button');
    }
}

Then in the Blade view, I can use:

<livewire:somemodule::button />

This works perfectly and avoids naming collisions.

However, when using Volt components, the render() method is not defined, and as a result, I cannot specify a view path or namespace. Volt components are always referenced like:

<livewire:button />

If multiple Volt components with the same name exist across different modules, one of them overwrites the others. This makes it impossible to use the same component name in different modules when using Volt.

Steps To Reproduce

  1. Create a Laravel modular project structure.
  2. In ModuleA, create a Volt component named Button.
  3. In ModuleB, create another Volt component also named Button.
  4. Attempt to reference both components in a Blade file (components will not be found):
<livewire:module-a::button />
<livewire:module-b::button />
  1. Observe that only one of the components is registered and used, due to lack of namespacing in Volt.
<livewire:button />

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions