dilansabah / laravel-inertia-vue
Laravel package to install Inertia.js with Vue 3 setup
Maintainers
Requires
- php: ^8.2|^8.3
- illuminate/support: ^11.0|^12.0|^13.0
README
Laravel Inertia Vue Starter 🚀
Laravel Inertia Vue Starter is a developer-friendly package designed to simplify the integration of Inertia.js with Vue 3 in Laravel applications. It automates dependency installation, scaffolds essential files, and provides a smooth setup experience with intelligent features like safe file handling, overwrite prompts, middleware auto-registration, and setup guidance when conflicts occur.
Features:
- Automatic installation of Inertia.js (Laravel adapter)
- Vue 3 + Inertia frontend setup
- Vite configuration ready to use
- Smart dependency detection (no duplicate installs)
- Safe file handling (no unwanted overwrites)
- Interactive overwrite confirmation
- --force option for full overwrite
- Auto-generated setup guide when files are skipped
- Automatic Inertia middleware creation and registration
- Clean and beginner-friendly setup
Installation: composer require dilansabah/laravel-inertia-vue php artisan inertia-vue:install npm run dev
What the Package Does:
- Installs inertiajs/inertia-laravel
- Installs npm packages: vue, @inertiajs/vue3, @vitejs/plugin-vue
- Creates or updates: resources/js/app.js resources/js/Pages/Home.vue resources/views/app.blade.php vite.config.js
- Creates HandleInertiaRequests middleware
- Registers middleware automatically in bootstrap/app.php
- Adds helpful comment in routes/web.php
- Generates setup guide if files are skipped
Skipped Files Handling: If important files already exist, the package:
- Asks before overwriting
- Skips if declined
- Generates inertia-vue-setup.md with instructions
Force Overwrite: php artisan inertia-vue:install --force
Generated Structure: resources/js/app.js resources/js/Pages/Home.vue resources/views/app.blade.php vite.config.js app/Http/Middleware/HandleInertiaRequests.php