Laravel 12 Starter Kit, and WorkOS Authentication

Laravel 12 was just released and it came with the starter kits for React, Vue, and Livewire, with the new support for WorkOS SSO Authentication.

WorkOS helps add enterprise login and security features easily, like SSO (Single Sign-On) and user management, without extra setup.

The supported PHP versions for Laravel 12 are 8.2–8.4.

Let’s install a fresh Laravel app (we will call the app laravel-12).

Open your terminal and run:

laravel new laravel-12

Starter kits displayed while creating a fresh Laravel 12 app

When you run the laravel new command, you should see React, Vue, and Livewire among the starter kit options. If you don’t see any of these starter kits, do these: i. Update the Laravel installer with composer global update laravel/installer. ii. If you use Herd, update Herd to the latest version. iii. Restart your terminal. iv. If it’s still the same, upgrade to **PHP 8.4**, and restart your terminal.

Select any of the starter kits you are convenient with, we decided to select Vue for this project.

In the next display, select WorkOS (Requires WorkOS account).

Authentication provider options after selecting a starter kit

In the next display, select Pest or PHPUnit.

Select Yes to Would you like to run npm install and npm run build?

🎉 We just created a new Laravel 12 app which we named laravel-12.

Start the app with php artisan serve or via Herd.

When you open the app on your browser, it should look like this:

Laravel 12 default landing page

Now, try to log in by clicking the login button in the top-right corner. You should see this error. This is because the WorkOS credentials were not set.

Error because WorkOS credentials were not set

Now, let’s set the WorkOS credentials

Create a WorkOS account and log in.

Navigate to API keys on WorkOS, copy your client id to WORKOS_CLIENT_ID and copy your secret key to WORKOS_API_KEY of your .env file.

Navigate to Redirects, set the redirect to the same value as your WORKOS_REDIRECT_URL e.g http://localhost:8000/authenticate.

Now, refresh your Laravel page. It should look like this:

WorkOS sig in page

Log in with Google or any other option, and be redirected to your dashboard

Hope this was helpful. Drop a comment below, and let me know what you think.

In case you want to see tips like this, give a follow.