Be part of JetBrains PHPverse 2026 on June 9 – a free online event bringing PHP devs worldwide together.

ravenshill's avatar

Upgrading a laravel/ui project to breeze (how to)

I have recently been upgrading a laravel project that was originally frameworked with bootstrap and laravel/ui, back in the day. Anyhoo. I wanted to use something more modern for authentication/registration etc.

Here is what I did, hopefully it may help others.

  1. I created a new branch and just tried the adding breeze as recommended for a new install. Failure, it blatted a lot of stuff.
  2. I created a new laravel project, without breeze, just plain vanilla.
  3. I made sure everything was working then ran git init and committed everything
  4. then I installed laravel/breeze (don't commit at this point)
  5. create a new branch for the project you are updating and use that
  6. use gst on the new (breeze) project to see what the install does.
  7. Add and remove files as needed. There are some files that change too, use git diff.
  8. install laravel/sanctum

The above approach worked for me and it took a few hours. Not as bad as I expected.

Below is what I ended up checking in to my project. You might use this as a check list.

On branch breeze
Changes not staged for commit:
  (use "git add/rm <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
	deleted:    app/Http/Controllers/Auth/ForgotPasswordController.php
	deleted:    app/Http/Controllers/Auth/LoginController.php
	deleted:    app/Http/Controllers/Auth/RegisterController.php
	deleted:    app/Http/Controllers/Auth/ResetPasswordController.php
	deleted:    app/Http/Controllers/Auth/VerificationController.php
	modified:   app/Models/User.php
	modified:   composer.json
	modified:   composer.lock
	modified:   database/factories/UserFactory.php
	modified:   public/css/app.css
	modified:   public/js/app.js
	modified:   public/mix-manifest.json
	modified:   resources/views/auth/login.blade.php
	deleted:    resources/views/auth/passwords/email.blade.php
	deleted:    resources/views/auth/passwords/reset.blade.php
	modified:   resources/views/auth/register.blade.php
	deleted:    resources/views/auth/verify.blade.php
	modified:   resources/views/dashboard.blade.php
	modified:   routes/web.php
	modified:   tailwind.config.js
	modified:   webpack.mix.js

Untracked files:
  (use "git add <file>..." to include in what will be committed)
	app/Http/Controllers/Auth/AuthenticatedSessionController.php
	app/Http/Controllers/Auth/ConfirmablePasswordController.php
	app/Http/Controllers/Auth/EmailVerificationNotificationController.php
	app/Http/Controllers/Auth/EmailVerificationPromptController.php
	app/Http/Controllers/Auth/NewPasswordController.php
	app/Http/Controllers/Auth/PasswordResetLinkController.php
	app/Http/Controllers/Auth/RegisteredUserController.php
	app/Http/Controllers/Auth/VerifyEmailController.php
	app/Http/Requests/
	app/View/
	config/sanctum.php
	database/migrations/2019_12_14_000001_create_personal_access_tokens_table.php
	resources/views/auth/confirm-password.blade.php
	resources/views/auth/forgot-password.blade.php
	resources/views/auth/reset-password.blade.php
	resources/views/auth/verify-email.blade.php
	resources/views/components/application-logo.blade.php
	resources/views/components/auth-card.blade.php
	resources/views/components/auth-session-status.blade.php
	resources/views/components/auth-validation-errors.blade.php
	resources/views/components/button.blade.php
	resources/views/components/dropdown-link.blade.php
	resources/views/components/dropdown.blade.php
	resources/views/components/input.blade.php
	resources/views/components/label.blade.php
	resources/views/components/nav-link.blade.php
	resources/views/components/responsive-nav-link.blade.php
	resources/views/layouts/
	resources/views/p_dashboard.blade.php
	resources/views/welcome.blade.php
	routes/auth.php
	tests/Feature/Auth/
0 likes
2 replies
jlrdw's avatar

It is recommended to start a new project with breeze, but this will probably help someone who wants to update to breeze with an existing project.

@ravenshill thanks for sharing this.

evev31's avatar

I just do that upgrade and I using git, so I can see what has been changed, and they changed the web.php file in the routes, I just see the new routes and copy the necessary code and then revert to my old routes. If you are using git, you can revert the changed file, but yes, it change many code.

Please or to participate in this conversation.