README

About Larast

Larast is a Laravel starter kit for development needs, providing a complete ready-to-use environment with popular and essential packages pre-installed.

Installation

You can install Larast in two ways:

1. Via Laravel Installer

Create a new project using Laravel installer with Larast as the starter kit:

laravel new my-app --using=kanekescom/larast

2. Via Composer

You can install Larast in two ways:

a. Using Composer Create-Project:

composer create-project kanekescom/larast my-app

b. Clone from GitHub:

git clone https://github.com/kanekescom/larast.git my-app
cd my-app
composer install

After installation, your application will be ready with all the essential packages and configurations set up.

Creating a User

You can create default users with predefined roles by running the database seeder:

php artisan db:seed

This will create users with the following credentials and roles:

Name	Email	Role	Password
Super Admin User	superadmin@larast.com	Super Admin	password
Admin User	admin@larast.com	Admin	password
Regular User	user@larast.com	User	password

AI Coding Assistance

For developers using AI coding assistants, run the following command to install the MCP server and coding guidelines:

php artisan boost:install

This will set up the Model Context Protocol (MCP) server and configure coding guidelines that enhance your AI-assisted development experience.

Keeping Guidelines Up-to-Date

You may want to periodically update your local AI guidelines to ensure they reflect the latest versions of the Laravel ecosystem packages you have installed. To do so, you can use the boost:update Artisan command:

php artisan boost:update

You may also automate this process by adding it to your Composer "post-update-cmd" scripts:

{
  "scripts": {
    "post-update-cmd": [
      "@php artisan boost:update --ansi"
    ]
  }
}

Laravel Octane

This project comes with Laravel Octane pre-installed for high-performance serving of your Laravel application. To use Octane with FrankenPHP (the default server for this project), you need to run the installation command:

php artisan octane:install

When prompted, select "frankenphp" as your server.

After installation, you can start your application using Octane with:

php artisan octane:start

For more information about Laravel Octane configuration and usage, please refer to the official Laravel Octane documentation.

Installed Packages

Larast comes with several pre-installed packages to help you build your application:

laravel/octane v2 - Supercharge your Laravel application's performance with high-powered application servers
laravel/boost v1 - Laravel Boost for enhanced AI-assisted development experience with Laravel
laravel/sail v1 - Docker files for running a basic Laravel application
laravel/telescope v5 - An elegant debug assistant for the Laravel framework
spatie/laravel-permission v6 - Permission handling for Laravel with roles and permissions management
spatie/laravel-query-builder v6 - Easily build Eloquent queries from API requests
barryvdh/laravel-debugbar v3 - Debugbar for Laravel (Integrates PHP Debug Bar)
barryvdh/laravel-ide-helper v3 - IDE Helper for generating helper files for Laravel facades and adding PHPDocs

Recommended Additional Packages

To further enhance your Laravel application, consider adding these recommended packages:

laravel/horizon - Dashboard and code-driven configuration for Laravel queues
laravel/nightwatch - Laravel Nightwatch for application monitoring and performance insights
laravel/passport - OAuth2 server and API authentication package that is simple and enjoyable to use
laravel/sanctum v - Featherweight authentication system for SPAs and simple APIs
laravel/socialite - Laravel Socialite for OAuth authentication with social networks
sentry/sentry-laravel - The official Laravel SDK for Sentry error tracking and monitoring

Refer to each package's documentation for specific installation and configuration instructions.

License

Larast is open-sourced software licensed under the MIT license.

kanekescom / larast

Maintainers

Details