README

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.

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

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

And then run,

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

php artisan serve

Viola! You've running a Laravel site using Paper Dashboard.

For more information on command

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.

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">
  <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.

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\PaperDashboard\Providers\AppServiceProvider" --tag="config"

Views

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

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

Next Step

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

Paper Dashboard need some package on npm. First you need to run

npm install

Install Paper Dashboard needed package from npm

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

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/paper-dashboard.js
resources/assets/js/auth.js
resources/assets/sass/paper-dashboard.scss
resources/assets/sass/auth.scss

Happy experimenting!

atnic / laravel-paper-dashboard

Maintainers

Details