gtcrais/inertia-vue-lsk

The Inertia + Vue skeleton application for the Laravel framework.

dev-master 2025-09-30 21:53 UTC

Requires

• php: ^8.4
• inertiajs/inertia-laravel: ^2.0.6
• laravel/framework: ^12.31
• laravel/sanctum: ^4.2
• laravel/socialite: ^5.23
• laravel/tinker: ^2.10.1
• predis/predis: ^2.4
• socialiteproviders/apple: ^5.7

Requires (Dev)

• barryvdh/laravel-debugbar: ^3.16
• fakerphp/faker: ^1.24.1
• laravel/pail: ^1.2.3
• laravel/pint: ^1.25.1
• laravel/sail: ^1.46
• mockery/mockery: ^1.6.12
• nunomaduro/collision: ^8.8.2
• pestphp/pest: ^3.8.4
• pestphp/pest-plugin-laravel: ^3.2

MIT

• framework
• laravel

README

Tech stack:

• Laravel (latest)
• Sanctum (latest)
• Inertia 2
• Vue 3
• Tailwind CSS 4

Additional Composer packages

• Sanctum
• Socialite
• Apple Socialite Provider
• Laravel Debugbar
• Predis

Features

Out of the box this starter kit provides:

• Login and registration functionalities using conventional email + password method with email confirmation, as well as Sign in with Facebook and Google
• Password reset functionality
• Inertia SSR
• Graceful exceptions handling
• Skeleton for mobile app requests handling (although this needs a little more work)

Requirements

• PHP >= 8.4
• Node.js >= 20
• Laravel queues (for emails)

Setup

• In .env fill out:

  • APP_URL
  • GRACEFULLY_HANDLE_EXCEPTIONS - boolean. If set to true you will get nice error pages instead of the default Inertia exception modal
  • SESSION_DOMAIN
  • SANCTUM_STATEFUL_DOMAINS
  • Mailgun credentials, unless you're using some other mailer
  • Facebook and Google credentials, if you're going to be using sign in with social networks feature
  • If you want to use Inertia SSR:
    • set VITE_SSR to true
    • npm run build
    • php artisan inertia:start-ssr
  • If you want to use Laravel Horizon, just install it and uncomment HorizonServiceProvider::class in bootstrap/providers.php, and update the gate() method

• Start the mail queue - php artisan queue:work --queue=mail

Things worth taking a look at

• app/Bootstrapers
• app/Http/Middleware/SanctumMiddleware.php
• app/Providers/StarterKitServiceProvider.php
• app/Services/InertiaHelperService.php used in app/Bootstrappers/ExceptionsHelper.php and app/Http/Middleware/HandlerInertiaRequests.php
• app/Services/ViewMetadataProviderService.php, used in app/Services/InertiaHelperService.php, app/Http/Controllers/PageController.php and resource/views/default.blade.php

License

inertia-vue-lsk Laravel Starter Kit is open-sourced software licensed under the MIT license.