atnic/laravel-paper-dashboard

Laravel package for integrating Paper Dashboard.

Laravel Paper Dashboard

Laravel Package for integrating Paper Dashboard template and this package is Laravel Mix friendly. Currently this package can be integrated easily only on fresh installation., _(*1)

Installation

composer require atnic/laravel-paper-dashboard

If you are using Laravel 5.5 above skip this step. Add this line on config/app.php, on providers, _(*2)

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

And then run,, _(*3)

php artisan make:paper-dashboard

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

php artisan serve

Viola! You've running a Laravel site using Paper Dashboard., _(*5)

For more information on command, _(*6)

php artisan make:paper-dashboard --help

Usage

This package provides view for auth and app. Take a look at resources/views/layouts/app.blade.php., _(*7)

In this file you can extends global section like menu., _(*8)

To extends menu add this in app.blade.php, _(*9)

@section('sidebar-menu')
<ul class="nav">
  <li class="{{ request()->routeIs('home') ? 'active' : '' }}">
    <a href="{{ route('home') }}">
      <i class="nc-icon nc-bank"></i>
      <p>Home</p>
    </a>
  </li>
</ul>
@endsection

This package give you free of choice to use any Laravel Package for Menu. We recommend spatie/laravel-menu or lavary/laravel-menu., _(*10)

Any new created page should extends this view., _(*11)

@extends('layouts.app')

// Your blade here

Configuration and Views Customization

Config

To publish this package config to your app config run, _(*12)

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

Views

To publish this package views so you can customize on your own run, _(*13)

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

Next Step

First of all, you should understand how to use Laravel Mix., _(*14)

Paper Dashboard need some package on npm. First you need to run, _(*15)

npm install

Install Paper Dashboard needed package from npm, _(*16)

npm install --save-dev bootstrap bootstrap-notify bootstrap-sass font-awesome popper.js perfect-scrollbar

Run Laravel Mix command, _(*17)

npm run development

or use production minimize output, _(*18)

npm run production

Then have a good look on these files - webpack.mix.js - resources/assets/js/paper-dashboard.js - resources/assets/js/auth.js - resources/assets/sass/paper-dashboard.scss - resources/assets/sass/auth.scss, _(*19)

Happy experimenting!, _(*20)