Weave Code
Breeze Laravel Package
laravel/breeze
Laravel Breeze is a lightweight starter kit for Laravel 11.x and earlier, providing simple authentication scaffolding to kickstart new apps quickly. For the latest official Laravel starter kits, see https://laravel.com/starter-kits.
Laravel Breeze is a lightweight starter kit for Laravel 11.x and earlier, designed to get authentication and a clean application scaffold in place with minimal overhead. It provides a simple, maintainable foundation you can extend as your app grows.
For the newest official options, see Laravel’s latest starter kits: https://laravel.com/starter-kits
- Authentication scaffolding (login, registration, password reset, email verification)
- Clean, minimal UI scaffolding to build on
- Sensible routes, controllers, and views wired up out of the box
- Easy to customize and replace as requirements evolve
Frequently asked questions about Breeze
- What Laravel versions does Breeze support?
- Breeze officially supports Laravel 11.x and earlier versions. For newer Laravel releases (12+), check Laravel’s latest starter kits or consider forks like `laravel/breeze-stack`. Always verify compatibility with your Laravel version before installation.
- Can I use Breeze with a custom frontend framework (e.g., Bootstrap, Bulma)?
- Breeze is tightly coupled with Tailwind CSS, so replacing it requires manual extraction of Tailwind classes or overriding styles. For non-Tailwind setups, consider Laravel Fortify or Jetstream for more flexibility, or manually strip Tailwind dependencies post-install.
- How do I install Breeze for an API-only Laravel app?
- Run `composer require laravel/breeze --dev` followed by `php artisan breeze:install api`. This skips Blade/Inertia views and focuses on Sanctum for stateless API authentication. Ensure your API routes use Sanctum’s middleware (`auth:sanctum`).
- Will Breeze work with my existing Laravel auth system?
- Yes, Breeze is designed for incremental adoption. Replace auth controllers (e.g., `LoginController`) and views while keeping middleware, policies, and database migrations. Test thoroughly, as some middleware (e.g., `auth`) may need reconfiguration.
- Does Breeze support Inertia.js with Vue or React?
- Breeze includes Inertia.js support for both Vue and React. Run `php artisan breeze:install inertia` to generate Inertia-specific views and pages. Ensure your Inertia setup includes SSR (Server-Side Rendering) for hydration compatibility, especially in Laravel 11+.
- How do I customize the registration or login validation rules?
- Extend the provided `RegisterRequest` or `LoginRequest` form request classes in `app/Http/Requests`. Override the `rules()` method to add or modify validation logic. For example, add `public function rules() { return array_merge(parent::rules(), ['custom_field' => 'required']); }`.
- Is Breeze suitable for production without modifications?
- Breeze is production-ready out of the box for basic auth needs (login, registration, password resets). However, production apps often require customization (e.g., email templates, rate limiting, or additional middleware). Test thoroughly, especially for edge cases like brute-force attacks.
- Can I use Breeze with Laravel Livewire?
- Yes, Breeze supports Livewire via the `breeze:install livewire` command. This generates Livewire components for auth flows. Ensure your Livewire setup includes proper middleware (e.g., `auth`) and that you’re using Livewire’s Blade directives correctly in the provided views.
- What are the alternatives to Breeze for Laravel auth?
- For minimalist auth, consider Laravel Fortify (more customizable) or Jetstream (feature-rich but heavier). For API-only, Sanctum alone or Laravel Passport (OAuth2) may suffice. If you need social logins or advanced features, Jetstream or custom solutions with Laravel’s auth contracts are better.
- How do I handle email verification in Breeze for production?
- Breeze includes email verification out of the box. For production, configure your `.env` with a real mail driver (e.g., SMTP or Mailgun) and set `MAIL_MAILER=smtp`. Test the verification flow end-to-end, including email delivery and the redirect after verification. Use queue workers (`php artisan queue:work`) for async processing.
Weaver
How can I help you explore Laravel packages today?