alfism1/ultimate-starter-kit

The Ultimate Starter Kit for Laravel Filament with Laravel Breeze and Inertia.js (Typescript)

dev-master 2024-07-07 00:37 UTC

Requires

• php: ^8.2
• bezhansalleh/filament-shield: ^3.2
• filament/actions: ^3.2
• filament/filament: ^3.2
• filament/forms: ^3.2
• filament/infolists: ^3.2
• filament/notifications: ^3.2
• filament/spatie-laravel-media-library-plugin: ^3.2
• filament/spatie-laravel-settings-plugin: ^3.2
• filament/tables: ^3.2
• filament/widgets: ^3.2
• inertiajs/inertia-laravel: ^1.0
• joshembling/image-optimizer: ^1.4
• laravel/framework: ^11.9
• laravel/sanctum: ^4.0
• laravel/tinker: ^2.9
• tightenco/ziggy: ^2.0
• z3d0x/filament-logger: ^0.7.2

Requires (Dev)

• fakerphp/faker: ^1.23
• laravel/breeze: ^2.0
• laravel/pint: ^1.13
• laravel/sail: ^1.26
• mockery/mockery: ^1.6
• nunomaduro/collision: ^8.0
• pestphp/pest: ^2.0
• pestphp/pest-plugin-laravel: ^2.0

MIT

• framework
• laravel

README

Ultimate Starter Kit

This is the ultimate starter kit for Laravel projects, designed to help you quickly set up and get started with modern web development practices.

Features

• Laravel Breeze
  • Inertia.js with React, SSR, and TypeScript
• Filament
  • Filament PHP
  • Spatie Media Library Plugin
  • Image Optimizer
  • Shield Plugin

Requirements

• PHP >= 8.2

Installation

1. Clone the repository:

   git clone https://github.com/alfism1/ultimate-starter-kit.git
   cd ultimate-starter-kit

2. Copy and configure the environment file:

   cp .env.example .env
   # Edit the .env file to configure your environment

3. Install dependencies:

   composer install
   npm install

4. Generate the application key:

   php artisan key:generate

5. Linking storage:

   php artisan storage:link

6. Run database migrations and seeders:

   php artisan migrate
   php artisan db:seed

7. Create a super admin:

   php artisan shield:super-admin

Usage

Development

To start the development server:

npm run dev

Production

To build the project for production:

npm run build

Run Jobs

php artisan queue:work

Adding New Policies

To create a new policy:

php artisan make:policy ResourceNamePolicy

Then configure the created policy in app/Policies/ResourceNamePolicy.php.

Contributing

Feel free to submit issues or pull requests. Contributions are welcome!

License

This project is licensed under the MIT License.

For more details, visit the repository.