Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Volt components inside packages not recognized or compiled despite Volt::mount() setup

Abierto
  • ¿Algo no está bien?
#138 1 comentario 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
4/5
Tiempo estimado
3-5 días
Aptitud para principiantes
35/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Estancado
Stack tecnológico
laravel, php
Área
backend, frontend

Línea de trabajo

Comienza reproduciendo el fallo con la llamada a Volt::mount() del ServiceProvider del paquete y la entrada Volt::route() en routes/web.php. Sigue cómo se descubre y compila la ruta montada resources/views/livewire y, después, verifica que la ruta vendor-package::section.example-component se renderiza correctamente sin producir una ComponentNotFoundException.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Volt Version

1.7.1

Laravel Version

12.21

PHP Version

8.4.10

Database Driver & Version

No response

Description

Volt components placed inside a Laravel package are not recognized or compiled, even when mounted using Volt::mount() from the main application.

Despite the following being correctly configured:

  • The .blade.php component exists in the expected path inside the package
  • The namespace is properly registered via Volt::mount()
  • The route is defined with the correct namespace and path
  • All caches are cleared (view:clear, optimize:clear, composer dump-autoload, etc.)

Volt throws:

Livewire\Exceptions\ComponentNotFoundException  
Unable to find component: [vendor-package::section.example-component]

These same components work fine when placed inside the main application’s resources/views/livewire folder, which confirms that Volt is not compiling or registering them from mounted package paths.

Steps To Reproduce

  1. Create a Laravel package (e.g. vendor/package-name)

  2. Inside the package, add a Volt component file at:

    resources/views/livewire/section/example-component.blade.php

  3. In your package’s ServiceProvider, mount the Volt views using:

    use Livewire\Volt\Volt;

public function boot(): void
{
    Volt::mount(
        __DIR__ . '/../resources/views/livewire',
        'vendor-package'
    );
}

  4. In the main Laravel application, define a Volt route in routes/web.php:

    use Livewire\Volt\Volt;

Volt::route('settings/example', 'vendor-package::section.example-component')
    ->name('settings.example');

  5. Run:

    php artisan optimize:clear
composer dump-autoload

  6. Visit /settings/example in the browser

✅ Expected: The Volt component renders normally
❌ Actual: Livewire throws a ComponentNotFoundException

Lenguaje dominante
PHP
Estrellas
422
Forks
35
Sin PR fusionados en 30 d

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de livewire/volt

Todos los issues de livewire/volt

Issues similares

Más issues de PHP

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.