README

This Starter kit contains my starting point when developing a new Laravel project. Its based on the official Livewire Starter kit, and includes the following features:

• ✅ User Management,
• ✅ Role Management,
• ✅ Permissions Management,
• ✅ Two-Factor Authentication (2FA)
• ✅ Teams - Collaborative team management (configurable)
• ✅ Social Login (Google, Facebook, Twitter/X)
• ✅ Localization options
• ✅ Separate Dashboard for Super Admins
• ✅ Updated for Laravel 12.0 and Livewire 3.0

Admin dashboard view:

Supporting multiple languages:

TALL stack

It uses the TALL stack, which stands for:

• Tailwind CSS
• Alpine.js
• Laravel
• Laravel Livewire using the components.

Further it includes:

Among other things, it also includes:

• Flux UI for flexible UI components (free version)
• Laravel Pint for code style fixes
• PestPHP for testing
• missing-livewire-assertions for extra testing of Livewire components by Christoph Rumpel
• LivewireAlerts for SweetAlerts
• Spatie Roles & Permissions for user roles and permissions
• Google2FA for Two-Factor Authentication (TOTP)
• Strict Eloquent Models for safety
• Laravel Debugbar for debugging
• Laravel IDE helper for IDE support

Upcoming features

I'm considering adding the following features, depending on my clients' most common requirements:

• Wire Elements / Modals for modals (still deciding - for now I'm using Flux UI for this)
• Laravel Cashier for Stripe integration

Requirements

• PHP 8.2 or higher (8.2, 8.3, 8.4, or 8.5)
• Composer
• Node.js 22+ and npm

Installation

laravel new my-project --using=mortenebak/tallstarter

You could also just use this repository as a starting point for your own project by clicking use template. If installing manually, these are the steps to install:

1. Install dependencies

composer install
npm install
npm run build # or npm run dev

2. Configure environment

Setup your .env file and run the migrations.

cp .env.example .env
php artisan key:generate
php artisan storage:link

3. Migration

php artisan migrate

4. Seeding

php artisan db:seed

5. Creating the first Super Admin user

php artisan app:create-super-admin

6. Set default timezone if different from UTC

// config/app.php
return [
    // ...

    'timezone' => 'Europe/Copenhagen' // Default: UTC

    // ...
];

Features

Users, Roles & Permissions

This starter kit includes a complete admin system at /admin for managing users, roles, and permissions, built on Spatie Roles & Permissions.

Key features:

• User, role, and permission CRUD in a separate admin dashboard
• Seeded default permissions and a Super Admin role
• php artisan app:create-super-admin command for creating the first admin
• User impersonation (gated by the impersonate permission)

For detailed information, see Users, Roles & Permissions Documentation.

Two-Factor Authentication

This starter kit includes built-in support for Two-Factor Authentication (2FA) using TOTP (Time-based One-Time Passwords), compatible with apps like Google Authenticator, Authy, and 1Password.

Key features:

• QR code generation for easy setup
• Recovery codes for account recovery
• Seamless integration with the authentication flow
• User-friendly interface

For detailed information, see Two-Factor Authentication Documentation.

Teams

This starter kit includes comprehensive teams functionality that allows users to create, manage, and collaborate within teams. Teams can be enabled or disabled via configuration, making it suitable for both single-user and multi-team applications.

Key features:

• Team creation and management
• Role-based access (Admin/Member)
• Email invitations with secure tokens
• Team switching
• Member and role management
• Configurable feature (enable/disable via config)

For detailed information, see Teams Documentation.

Social Login

This starter kit includes support for social authentication using Laravel Socialite. Users can sign in or register using their Google, Facebook, or Twitter/X accounts.

Key features:

• OAuth 2.0 support for Google and Facebook
• OAuth 1.0a support for Twitter/X
• Automatic account creation for new social login users
• Random password generation for social accounts
• Email verification automatically set

For detailed setup instructions, see Social Login Documentation.

Developing

Check for code style issues

composer review

This command will run, in order:

• Laravel/Pint
• PHPStan
• Rector (dry-run)
• PestPHP

Ensuring that your code is up to standard and tested.

Troubleshooting

"Unable to locate file in Vite manifest"

The frontend assets haven't been built yet. Run:

npm run build # or npm run dev

Storage permission errors

If you see errors writing to logs or cache, make sure the storage and bootstrap/cache directories are writable by your web server user, and that the storage symlink exists:

php artisan storage:link

"Database file does not exist" (SQLite)

The default .env uses SQLite. Create the database file and run the migrations:

touch database/database.sqlite
php artisan migrate

Contributing

Feel free to contribute to this project by submitting a pull request. See the Contributing Guide for local setup, the composer review workflow, and PR conventions. Here's a great resource on how to contribute to open source projects.

Credits

I'd like to thank all the people who have contributed to the packages used in this project. Especially Spatie for their great packages, Livewire and Alpinejs for their awesome framework and the Laravel community for their great work. And of course Laravel for their awesome framework, and their Livewire Starter Kit, which this kit is based on.

Contributors

Take a look at the contributors who have helped make this project better. Many thanks!

Donate

If you like this project, please consider donating to support it.

Thanks to:

• Grazulex