sayidassegaf/starter

Laravel Starter Project

Updated for Laravel 10.0

This repository contains my starting point when developing a new Laravel project. It comes with a basic user management, role management and permissions management and a dashboard.

It includes the TALL stack from the preset at Tallstack.dev:

• Tailwind CSS
• Alpine.js
• Laravel
• Laravel Livewire

Further it includes:

• Laravel Pint for code style fixes
• PestPHP for testing
• Strict Eloquent Models for safety
• Laravel Debugbar for debugging
• Laravel IDE helper for IDE support
• Spatie Roles & Permissions for user roles and permissions
• Wire Elements / Modals for modals

Installation

After cloning the repository, do the following:

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

Contributing

Feel free to contribute to this project by submitting a pull request.

Todo

1. Option for user to change password
2. Option for user to change name and email address
3. Option for user to delete account
4. Add tests
5. Add tests for the user management
6. Add tests for the role management
7. Add tests for the permission management
8. Add tests for the dashboard
9. Add more documentation

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. Furthermore, the Tallstack.dev team for their preset. And of course Laravel for their awesome framework.

Donate

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