ay4t / starterkit

Repository from Github https://github.comay4t/starterkitRepository from Github https://github.comay4t/starterkit

πŸš€ Laravel Starter Kit

A robust and feature-rich Laravel starter kit built with modern technologies and best practices. This starter kit provides a solid foundation for building web applications with authentication, authorization, and team management capabilities.

✨ Features

  • πŸ”’ Authentication System - Powered by Laravel Jetstream
  • πŸ‘₯ Team Management - Built-in team collaboration features
  • πŸ›‘οΈ Role-Based Access Control - Using Spatie Laravel Permission
  • 🎨 Modern Frontend - Using Livewire and TailwindCSS
  • πŸ“‘ API Support - Built-in API authentication using Laravel Sanctum

πŸ› οΈ Tech Stack

βš™οΈ Backend

  • PHP 8.2+
  • Laravel 11.x
  • Laravel Jetstream 5.3
  • Spatie Laravel Permission 6.10
  • Laravel Sanctum 4.0
  • Maatwebsite Excel 3.1

πŸ“± Frontend

  • Livewire 3.0
  • TailwindCSS
  • Tailwind Forms
  • Tailwind Typography

🧰 Development Tools

  • Laravel Pail
  • Laravel Pint
  • Laravel Sail
  • Vite 6.0

⚠️ Prerequisites

  • PHP >= 8.2
  • Composer
  • Node.js & NPM
  • Database (MySQL/MariaDB)

βš™οΈ Installation

  1. Clone the repository
git clone <repository-url>
cd laravel-starter-kit
  1. Install PHP dependencies
composer install
  1. Install NPM dependencies
npm install
  1. Create environment file
cp .env.example .env
  1. Generate application key
php artisan key:generate
  1. Configure your database in .env file
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database
DB_USERNAME=your_username
DB_PASSWORD=your_password
  1. Run migrations and seeders
php artisan migrate --seed

πŸ§‘β€πŸ’» User Roles and Permissions

The starter kit comes with predefined roles and permissions:

🎭 Roles

  • Admin
  • Editor
  • User
  • Viewer

πŸ”’ Permissions

  • manage_users
  • manage_roles
  • manage_permissions
  • view_reports
  • manage_settings
  • edit_content
  • delete_content
  • publish_content
  • view_content
  • view_own_profile
  • edit_own_profile
  • create_content
  • comment
  • like_content

πŸ§‘β€πŸ’» Development

Start the development server:

php artisan serve

Watch for frontend changes:

npm run dev

πŸ§ͺ Testing

Run PHPUnit tests:

php artisan test

πŸ“œ License

This Laravel Starter Kit is open-sourced software licensed under the MIT license.

About


Languages

Language:PHP 50.1%Language:Blade 49.5%Language:JavaScript 0.3%Language:CSS 0.0%