README

Laravel 5.4 Package for integrating SB Admin 2 template and this package is Laravel Mix friendly. Currently this package can be integrated easily only on fresh installation.

Installation

composer require atnic/laravel-sb-admin-2

Add this line on config/app.php, on providers

'providers' => [
  ...
  Atnic\SBAdmin2\Providers\AppServiceProvider::class,
  ...
]

And then run,

php artisan make:sb-admin-2

Let's see what we've install. First, make sure that you already ran php artisan migrate command, then do

php artisan serve

Viola! You've running a Laravel site using SB Admin 2.

For more information on command

php artisan make:sb-admin-2 --help

Usage

This package provides view for auth and app. Take a look at resources/views/layouts/app.blade.php.

In this file you can extends global section like menu.

To extends menu add this in app.blade.php

@section('sidebar-menu')
<ul class="nav" id="side-menu">
  <li>
    <a href="{{ route('home') }}" class="active"><i class="fa fa-home fa-fw"></i> Home</a>
  </li>
</ul>
@endsection

This package give you free of choice to use any Laravel Package for Menu and Breadcrumb. We recommend spatie/laravel-menu or lavary/laravel-menu.

Any new created page should extends this view.

@extends('layouts.app')

// Your blade here

Configuration and Views Customization

Config

To publish this package config to your app config run

php artisan vendor:publish --provider="Atnic\SBAdmin2\Providers\AppServiceProvider" --tag="config"

Views

To publish this package views so you can customize on your own run

php artisan vendor:publish --provider="Atnic\SBAdmin2\Providers\AppServiceProvider" --tag="views"

Next Step

First of all, you should understand how to use Laravel Mix.

SB Admin 2 need some package on npm. First you need to run

npm install

Install SB Admin 2 needed package from npm

npm install --save-dev bootstrap-social datatables.net datatables.net-bs datatables.net-responsive datatables.net-responsive-bs font-awesome metismenu raphael morris.js startbootstrap-sb-admin-2

Run Laravel Mix command

npm run development

or use production minimize output

npm run production

Then have a good look on these files

webpack.mix.js
resources/assets/js/sb-admin-2.js
resources/assets/js/auth.js
resources/assets/sass/sb-admin-2.scss
resources/assets/sass/auth.scss

Happy experimenting!

atnic / laravel-sb-admin-2

Maintainers

Details