README

Laravel-Boilerplate

Everything you need to start your Laravel journey - application template, system management, CRUD generator and UI components built on Bootstrap and Livewire.

Created by SteelAnts s.r.o.

Preview

boilerplate.steelants.cz

Features

SteelAnts Laravel-Boilerplate provides:

Responsive app template (Bootstrap, Livewire, light/dark theme)
User management
Job management
Cache management
Backup manager
Log viewer
Audit log
API routes page
Menu builder
Alert system
CRUD generator
UI components (tabs, breadcrumb, gantt, pie graph, selectbox, searchbox)
Modal for opening any Livewire component
Quill editor

Documentation

Upgrade guides:

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',
    ]);
});

Alerts

types

success
error
warning
info

RELOAD type

	Alert::add(type: 'info', text: 'Informační zpráva po redirektu', icon: '', mode: AlertModeType::RELOAD, persist: false);

INSTANT type

	Alert::add(type: 'error', text: 'Error zpráva ve stejném requestu', icon: '', mode: AlertModeType::INSTANT, persist: false);

parametry

icon - využívá defaultní ikonu dle typu, pokud není nastavena persist - pokud je true, zůstává notifikace aktivní dokud ji neodklikne uživatel nebo neprovede redirect.

Commands

Command	Description
install:boilerplate	Install or update boilerplate scaffolding into the project
make:crud	Scaffold a full CRUD resource (DataTable, Form, controller, routes, tests)
make:basic-tests	Generate basic route coverage tests
job:dispatch	Dispatch a job by class name

Components

Component	Tag	Description
Tab Group	`<x-boilerplate::tab.group>`	Bootstrap tabs with Alpine.js state and cookie persistence
Breadcrumb	`<x-boilerplate::breadcrumb>`	Bootstrap breadcrumb from associative array
Gantt	`<x-boilerplate::gantt>`	Horizontal Gantt chart with day/week/month scale
Pie Graph	`<x-boilerplate::pie-graph>`	Chart.js pie chart
Selectbox	`<x-boilerplate::selectbox>`	Alpine.js select with tags mode and multi-select
Selectbox Ajax	`<x-boilerplate::selectbox-ajax>`	Selectbox with server-side Livewire search
Searchbox	`<x-boilerplate::searchbox>`	Client-side filtered dropdown search
Alert	`alert()->success()->now()`	Snackbar notifications for Livewire and HTTP contexts
Action Button	`<x-boilerplate::action-button>`	Livewire button with scoped loading state, confirm and disabled reason tooltip
Alert (inline)	`<x-boilerplate::alert>`	Inline alert with icon, title, actions and close button
Icon Tile	`<x-boilerplate::icon-tile>`	Square icon with a soft background in a theme color
Stat	`<x-boilerplate::stat>`	Number tile with icon
Progress	`<x-boilerplate::progress>`	Progress bar with label, percentage and indeterminate state
Dropdown	`<x-boilerplate::dropdown>`	Actions menu with icons, danger items and dividers
Detail List	`<x-boilerplate::detail-list>`	Label / value rows for detail pages
Time	`<x-boilerplate::time>`	Relative time with exact date in a tooltip
Copy	`<x-boilerplate::copy>`	Copy to clipboard
Empty State	`<x-boilerplate::empty-state>`	Empty list placeholder
Nav Switch	`<x-boilerplate::nav-switch>`	Segmented switch
Ace editor	`<x-form::ace>`	Options, read-only mode, light/dark theme, npm loading

Development

Contributors

Other Packages

License

This package is open-sourced software licensed under the Apache License 2.0.

steelants / laravel-boilerplate

Package info

Security

Statistics