Looking to hire Laravel developers? Try LaraJobs

laravel-headless maintained by ssdev

Description
Installable Laravel foundation with authentication, teams, roles, 2FA and multi-tenancy, shipped with a Vue + Inertia UI and a JSON API.
Author
Sead Silajdzic
Last update
2026/10/21 09:10 (dev-main)
License
MIT
Links
GitHub - Packagist
Downloads
5
Tags
two-factor - laravel - multi-tenancy - teams - starter-kit - vue - inertia

dev-main

Last update
2026/10/21 09:10
License
MIT
Require
  • php ^8.3
  • illuminate/contracts ^12.0|^13.0
  • illuminate/support ^12.0|^13.0
  • inertiajs/inertia-laravel ^3.5
  • laravel/prompts ^0.3
  • laravel/fortify ^1.41
  • spatie/laravel-permission ^8.3
  • laravel/sanctum ^4.3
v0.2.0

Last update
2026/10/21 08:53
License
MIT
Require
  • php ^8.3
  • illuminate/contracts ^12.0|^13.0
  • illuminate/support ^12.0|^13.0
  • inertiajs/inertia-laravel ^3.5
  • laravel/fortify ^1.41
  • laravel/prompts ^0.3
  • spatie/laravel-permission ^8.3
v0.1.1

Last update
2026/10/21 00:12
License
MIT
Require
  • php ^8.3
  • illuminate/contracts ^12.0|^13.0
  • illuminate/support ^12.0|^13.0
  • inertiajs/inertia-laravel ^3.5
  • laravel/prompts ^0.3
v0.1.0

Last update
2026/10/21 00:05
License
MIT
Require
  • php ^8.3
  • illuminate/contracts ^12.0|^13.0
  • illuminate/support ^12.0|^13.0
  • inertiajs/inertia-laravel ^3.5
  • laravel/prompts ^0.3
Comments
comments powered by Disqus

Laravel Headless

An installable Laravel foundation: authentication, user management, roles and permissions, teams, two-factor authentication and multi-tenancy — each shipped with a Vue + Inertia UI, a JSON API and tests.

The code stays in the package, so security fixes and improvements reach your app through composer update. Anything you want to change, you publish and own.

Requirements

  • PHP 8.3+
  • Laravel 12 or 13
  • Node 20+

Installation

Start from a fresh Laravel application:

laravel new my-app
cd my-app
composer require ssdev/laravel-headless
php artisan headless:install

The installer asks which features you want, wires up Inertia, Vue, Tailwind and the error pages, and never overwrites a file you changed without asking first. It is safe to run again.

Non-interactive installs (CI, scripts):

php artisan headless:install --features=teams,two-factor --no-interaction --force --npm

Customization

From the lightest touch to the heaviest:

  1. Config — publish config/headless.php and adjust routes, middleware and feature options.

  2. Swap a class — services, actions and form requests are resolved through the container, so you can bind your own implementation without copying anything.

  3. Publish a file — copy a single page, component or layout into your project:

    php artisan headless:publish pages/Dashboard.vue

    The copy lands in resources/js/vendor/headless/ and replaces the package version everywhere it is used. A published file no longer receives package updates.

Translations and the root Blade view can be published with vendor:publish --tag=headless-lang and --tag=headless-views. The package ships English only; add your language by translating the published files.

Updating

composer update ssdev/laravel-headless
npm run build

Everything you have not published is updated. Changes that need action on your side are listed in CHANGELOG.md. The package follows semantic versioning: breaking changes to the API, config or swappable classes only happen in major versions.

Contributing

See CONTRIBUTING.md.

License

MIT. See LICENSE.md.