steelants/laravel-boilerplate

Everything you need to start your Laravel journey.

1.4.0 2025-03-11 20:15 UTC

README

Currently WIP

Created by: SteelAnts s.r.o.

Total Downloads

Preview

boilerplate.steelants.cz

What's included

Functions

  • User Management
  • Job Management
  • Cache Management
  • Backup Manager
  • Log Viewer
  • Audit
  • API Routes view page
  • Menu builder
  • From builder
  • Datatable builder

Template

  • Reponsive app template
  • Light/dark theme
  • Build on Bootstrap and Livewire
  • Quill editor

Install

composer require steelants/laravel-boilerplate
composer install

#add Basic Controllers Routes and Features to APP namespace for customization
php artisan install:boilerplate

Import javascript and styles (includes bootstrap and font awesome)

// /resources/scss/app.scss
@import "./boilerplate/boilerplate.scss"
// /resources/js/app.scss
import './boilerplate/boilerplate.js';

Note

If you need customize any of included js/scss files, don't change files inside boilerplate folder. Instead create new root file boilerplate.scss/js by copying it from boilerplate folder. By changing paths of imported files you can make your custom verison or keep importing from boilerplate. When you update boilerplate package you will need to check changes only in root files boilerplate.scss/js and update your custom version accordingly.

Menu Builder

Single Level

Menu::make('main-menu', function ($menu) {
    $systemRoutes = [
        'general' => ['fas fa-eye', 'general.index'],
    ];

    foreach ($systemRoutes as $title => $route_data) {
        $icon = $route_data[0];
        $route = $route_data[1];

        $menu->add($title, [
            'id' => strtolower($title),
            'icon' => $icon,
            'route' => $route,
        ]);
    }
});

with sub Menu Builder

Multi Level

Menu::make('main-menu', function ($menu) {
    $mainItem = $menu->add('Home', [
        'id' => strtolower('Home'),
        'icon' => 'fas fa-eye',
        'route' => 'general.index',
    ]);

    $mainItem->add('Dashboard', [
        'id' => strtolower('Home-Dashboard'),
        'icon' => 'fas fa-eye',
        'route' => 'general.sub-index',
    ]);
});

Development

  1. Create subfolder /packages at root of your laravel project

  2. clone repository to sub folder /packages (you need to be positioned at root of your laravel project in your terminal)

git clone https://github.com/steelants/Laravel-Boilerplate.git ./packages/Laravel-Boilerplate
  1. edit composer.json file
"autoload": {
	"psr-4": {
		"SteelAnts\\LaravelBoilerplate\\": "packages/Laravel-Boilerplate/src/"
	}
}
  1. Add provider to bootstrap/providers.php
return [
	...
	SteelAnts\LaravelBoilerplate\BoilerplateServiceProvider::class,
	...
];
  1. use commands to aplicate changes
composer dump-autoload
  1. aplicate packages changes - before this you need have auth package
php artisan install:boilerplate --force

CRUD

Create CRUD

Create default files in model livewire

php artisan make:crud {model name}

Create CRUD Forced

Create default files in model livewire with ovewrite

php artisan make:crud {model name} --force

Create CRUD Full Page

Create default files in livewire with create and edit as full page

php artisan make:crud {model name} --full-page-components

Contributors

Other Packages

steelants/laravel-auth

steelants/laravel-boilerplate

steelants/datatable

steelants/form

steelants/modal

steelants/laravel-tenant

Notes