├── .styleci.yml
├── LICENSE.md
├── README.md
├── composer.json
├── package-lock.json
├── package.json
├── public
    ├── favicon.ico
    ├── images
    │   └── avatar.svg
    ├── laravel-dashboard-template.css
    └── mix-manifest.json
├── resources
    ├── sass
    │   ├── _tailwind.scss
    │   └── app.scss
    └── views
    │   ├── components
    │       ├── card.blade.php
    │       ├── dropdown.blade.php
    │       ├── dropdown_item.blade.php
    │       └── topbar.blade.php
    │   ├── page.blade.php
    │   └── partials
    │       ├── alert.blade.php
    │       ├── alert_error.blade.php
    │       ├── alert_success.blade.php
    │       ├── dropdown_arrow.blade.php
    │       ├── menu_toggle.blade.php
    │       ├── sidebar.blade.php
    │       ├── sidebar_link.blade.php
    │       ├── sidebar_logo.blade.php
    │       └── topbar_profile_dropdown.blade.php
├── src
    ├── Console
    │   ├── InstallCommand.php
    │   └── PublishCommand.php
    ├── Http
    │   ├── Controllers
    │   │   └── LogoutController.php
    │   └── routes.php
    ├── LaravelDashboardTemplate.php
    ├── LaravelDashboardTemplateApplicationServiceProvider.php
    ├── LaravelDashboardTemplateFacade.php
    └── LaravelDashboardTemplateServiceProvider.php
├── stubs
    └── LaravelDashboardTemplateServiceProvider.stub
├── tailwind.config.js
└── webpack.mix.js


/.styleci.yml:
--------------------------------------------------------------------------------
1 | preset: laravel
2 | 
3 | disabled:
4 |   - single_class_element_per_statement
5 | 


--------------------------------------------------------------------------------
/LICENSE.md:
--------------------------------------------------------------------------------
 1 | MIT License
 2 | 
 3 | Copyright (c) Stratulat Alexandru
 4 | 
 5 | Permission is hereby granted, free of charge, to any person obtaining a copy
 6 | of this software and associated documentation files (the "Software"), to deal
 7 | in the Software without restriction, including without limitation the rights
 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 | 
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 | 
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | <p align="center"><img src="https://coltorapps.com/images/ldt-screenshot.png" width="80%"></p>
  2 | <h1 align="center">Laravel Dashboard Template</h1>
  3 | <p align="center">
  4 | 💫Basic Dashboard Template as a Package.💫
  5 | </p>
  6 | <p align="center">
  7 | <img src="https://img.shields.io/packagist/vpre/sandulat/laratron.svg">
  8 | <img src="https://img.shields.io/github/license/sandulat/laratron.svg">
  9 | <a href="https://twitter.com/intent/follow?screen_name=sandulat">
 10 |   <img src="https://img.shields.io/twitter/follow/sandulat.svg?style=social">
 11 | </a>
 12 | <p>
 13 | 
 14 | > Note: Not suitable for single page applications as it's built in `Blade`, however you can use Vue/React/etc. components on all pages.
 15 | 
 16 | ## Installation
 17 | 
 18 | ```bash
 19 | composer require sandulat/laravel-dashboard-template
 20 | php artisan laravel-dashboard-template:install
 21 | ```
 22 | 
 23 | > Note: to re-publish the front-end assets when updating the package use: `php artisan laravel-dashboard-template:publish`
 24 | 
 25 | The `install` command will publish the front-end assets and will create a new service provider `App\Providers\DashboardServiceProvider`. This is basically the main config of the template, but first let's see how to display the dashboard in the next section.
 26 | 
 27 | ## Layout
 28 | 
 29 | Create a route and a controller that will return a view. Inside the view place the following code:
 30 | 
 31 | `my_view.blade.php:`
 32 | ```blade
 33 | @extends('laravel-dashboard-template::page')
 34 | 
 35 | @section('ldt-content')
 36 |     Some content
 37 | @endsection
 38 | ```
 39 | 
 40 | > Note: `ldt` stands for `laravel-dashboard-template`.
 41 | 
 42 | As you can see `laravel-dashboard-template::page` is just a layout. Besides `ldt-content` the layout provides more additional slots:
 43 | - `ldt-head` - Head section for CSS, meta, etc.
 44 | - `ldt-scripts` - Scripts section to include JS files.
 45 | - `ldt-topbar-left` - Left section of topbar.
 46 | - `ldt-topbar-right` - Right section of topbar, next to profile dropdown.
 47 | - `ldt-sidebar-footer` - Footer section of sidebar.
 48 | 
 49 | To avoid duplication of these slots, it would be better to create your own layout that will extend the package's layout.
 50 | 
 51 | `my_layout.blade.php:`
 52 | ```blade
 53 | @extends('laravel-dashboard-template::page')
 54 | 
 55 | @section('ldt-topbar-right')
 56 |     Language Select
 57 | @endsection
 58 | ```
 59 | 
 60 | So now in your views you can do:
 61 | 
 62 | `my_view.blade.php:`
 63 | ```blade
 64 | @extends('my_layout')
 65 | 
 66 | @section('ldt-content')
 67 |     Some content
 68 | @endsection
 69 | ```
 70 | 
 71 | ## Card
 72 | 
 73 | Besides layout, the package provides a card component:
 74 | 
 75 | ```blade
 76 | @component('laravel-dashboard-template::components.card')
 77 |     @slot('title')
 78 |         Dahboard
 79 |     @endslot
 80 | 
 81 |     Content
 82 | @endcomponent
 83 | ```
 84 | 
 85 | The result can be seen in the screenshot at the top of the documentation.
 86 | 
 87 | ## Alerts
 88 | 
 89 | Out of the box the package will display 2 types of alerts above the `content` section of the layout. They will be displayed when you redirect with `success` and `error` flash data:
 90 | 
 91 | ```php
 92 | return back()->with('success', 'My success message.');
 93 | ```
 94 | 
 95 | ```php
 96 | return back()->with('error', 'My error message.');
 97 | ```
 98 | 
 99 | ## Configuration
100 | 
101 | You can configure the dashboard inside the installed provider: `App\Providers\DashboardServiceProvider`. By default it's empty because everything is already configured so you can start building instantly, however you can add the following methods to start customizing the dashboard:
102 | 
103 | ```php
104 | /**
105 |  * Topbar user name resolver.
106 |  *
107 |  * @return string
108 |  */
109 | public function userName(): string
110 | {
111 |     return Auth::check() ? Auth::user()->name : 'Guest';
112 | }
113 | ```
114 | ```php
115 | /**
116 |  * Topbar user avatar resolver.
117 |  *
118 |  * @return string
119 |  */
120 | public function userAvatar(): string
121 | {
122 |     if (Auth::check() && Auth::user()->avatar) {
123 |         return Auth::user()->avatar;
124 |     }
125 | 
126 |     return URL::asset('/vendor/laravel-dashboard-template/images/avatar.svg')
127 | }
128 | ```
129 | ```php
130 | /**
131 |  * Sidebar links.
132 |  *
133 |  * @return array
134 |  */
135 | public function sidebarLinks(): array
136 | {
137 |     return [
138 |         'Menu' => [
139 |             [
140 |                 'label' => 'Users',
141 |                 'url' => route('users'),
142 |                 'children' => [
143 |                     [
144 |                         'label' => 'Active Users',
145 |                         'url' => route('users.active'),
146 |                     ],
147 |                 ],
148 |             ],
149 |         ],
150 |     ];
151 | }
152 | ```
153 | ```php
154 | /**
155 |  * Profile dropdown links.
156 |  *
157 |  * @return array
158 |  */
159 | public function profileDropdownLinks(): array
160 | {
161 |     return [
162 |         [
163 |             'label' => 'Edit Profile',
164 |             'url' => route('profile'),
165 |         ],
166 |     ];
167 | }
168 | ```
169 | ```php
170 | /**
171 |  * Logout the user.
172 |  *
173 |  * @param \Illuminate\Http\Request $request
174 |  * @return void
175 |  */
176 | public function logout(Request $request): void
177 | {
178 |     Auth::guard()->logout();
179 | 
180 |     $request->session()->invalidate();
181 | }
182 | ```
183 | ```php
184 | /**
185 |  * Action to be performed after logout.
186 |  *
187 |  * @return void
188 |  */
189 | public function loggedOut(): void
190 | {
191 |     //
192 | }
193 | ```
194 | ```php
195 | /**
196 |  * Redirect after logout.
197 |  *
198 |  * @return \Illuminate\Http\RedirectResponse
199 |  */
200 | public function logoutRedirect(): RedirectResponse
201 | {
202 |     return redirect('/');
203 | }
204 | ```
205 | 
206 | > Note: Each method from this service provider has dependency injection available.
207 | 
208 | ## Customization
209 | 
210 | I've tried to split the template into as many components & partials as possible. Just create inside your project the folder: `resources/views/vendor/laravel-dashboard-template` and now you can copy the files from the package and customize them. Here is the list:
211 | - partials/alert.blade.php
212 | - partials/alert_error.blade.php
213 | - partials/alert_success.blade.php
214 | - partials/sidebar.blade.php
215 | - partials/sidebar_link.blade.php
216 | - partials/sidebar_logo.blade.php
217 | - partials/topbar_profile_dropdown.blade.php
218 | 
219 | ---
220 | 
221 | - components/card.blade.php
222 | - components/dropdown.blade.php
223 | - components/dropdown_item.blade.php
224 | - components/topbar.blade.php
225 | 
226 | ## Using Vue/React/etc. components
227 | 
228 | The main div that wraps the dashboard has an `app` id. You can load your front-end framework onto this id and start using your components on all pages.
229 | 
230 | ```jsx
231 | // Vue
232 | new Vue({
233 |     el: '#app',
234 | });
235 | 
236 | //React
237 | ReactDOM.render(<App />, document.getElementById('app'));
238 | ```
239 | 
240 | After you'll compile your front-end assets you can include them like this:
241 | ```blade
242 | @section('ldt-head')
243 |     <link href="{{ mix('/css/app.css') }}" rel="stylesheet">
244 | @endsection
245 | @section('ldt-scripts')
246 |     <script src="{{ mix('/js/app.js') }}"></script>
247 | @endsection
248 | ```
249 | 
250 | > Note: If you don't have [front-end assets versioning](https://laravel.com/docs/5.8/mix#versioning-and-cache-busting) you might want to use the `asset()` method instead of `mix()`.
251 | 
252 | ## Custom Logout Button
253 | 
254 | You can hide the default logout button by applying `display: none;` onto id `#ldt-logout-button`. The template already provides a logout system with customizable callbacks, so you can make use of it. Just submit the default "hidden" logout form with Javascript:
255 | ```js
256 | document.getElementById("ldt-logout-form").submit();
257 | ```
258 | 
259 | ## Credits
260 | 
261 | Created by [Stratulat Alexandru](https://twitter.com/sandulat).
262 | 
263 | <a href="https://coltorapps.com/">
264 |   <img src="https://coltorapps.com/images/logo_transparent.png" width="150px">
265 | </a>
266 | 
267 | 


--------------------------------------------------------------------------------
/composer.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "name": "sandulat/laravel-dashboard-template",
 3 |   "description": "Basic Laravel Dashboard Template",
 4 |   "keywords": [
 5 |     "sandulat",
 6 |     "laravel-dashboard-template"
 7 |   ],
 8 |   "homepage": "https://github.com/sandulat/laravel-dashboard-template",
 9 |   "license": "MIT",
10 |   "type": "library",
11 |   "authors": [
12 |     {
13 |       "name": "Stratulat Alexandru",
14 |       "email": "alexanderstratulat97@gmail.com",
15 |       "role": "Developer"
16 |     }
17 |   ],
18 |   "require": {
19 |     "php": "^7.1",
20 |     "illuminate/support": "5.8.*",
21 |     "laravel/framework": "~5.8.0|~5.9.0"
22 |   },
23 |   "require-dev": {
24 |     "orchestra/testbench": "3.8.*",
25 |     "phpunit/phpunit": "^7.0"
26 |   },
27 |   "autoload": {
28 |     "psr-4": {
29 |       "Sandulat\\LaravelDashboardTemplate\\": "src"
30 |     }
31 |   },
32 |   "autoload-dev": {
33 |     "psr-4": {
34 |       "Sandulat\\LaravelDashboardTemplate\\Tests\\": "tests"
35 |     }
36 |   },
37 |   "scripts": {
38 |     "test": "vendor/bin/phpunit",
39 |     "test-coverage": "vendor/bin/phpunit --coverage-html coverage"
40 |   },
41 |   "config": {
42 |     "sort-packages": true
43 |   },
44 |   "extra": {
45 |     "laravel": {
46 |       "providers": [
47 |         "Sandulat\\LaravelDashboardTemplate\\LaravelDashboardTemplateServiceProvider"
48 |       ],
49 |       "aliases": {
50 |         "LaravelDashboardTemplate": "Sandulat\\LaravelDashboardTemplate\\LaravelDashboardTemplateFacade"
51 |       }
52 |     }
53 |   }
54 | }


--------------------------------------------------------------------------------
/package.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "private": true,
 3 |   "scripts": {
 4 |     "dev": "npm run development",
 5 |     "development": "cross-env NODE_ENV=development node_modules/webpack/bin/webpack.js --progress --hide-modules --config=node_modules/laravel-mix/setup/webpack.config.js",
 6 |     "watch": "npm run development -- --watch",
 7 |     "hot": "cross-env NODE_ENV=development node_modules/webpack-dev-server/bin/webpack-dev-server.js --inline --hot --config=node_modules/laravel-mix/setup/webpack.config.js",
 8 |     "prod": "npm run production",
 9 |     "production": "cross-env NODE_ENV=production node_modules/webpack/bin/webpack.js --no-progress --hide-modules --config=node_modules/laravel-mix/setup/webpack.config.js"
10 |   },
11 |   "devDependencies": {
12 |     "cross-env": "^5.2.0",
13 |     "laravel-mix": "^4.0.15",
14 |     "laravel-mix-purgecss": "^4.1.0",
15 |     "sass": "^1.20.1",
16 |     "sass-loader": "^7.1.0",
17 |     "tailwindcss": "^1.0.2"
18 |   }
19 | }
20 | 


--------------------------------------------------------------------------------
/public/favicon.ico:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/sandulat/laravel-dashboard-template/d88893211fa928d3d5fe40dcbf1cfc6742e50b40/public/favicon.ico


--------------------------------------------------------------------------------
/public/images/avatar.svg:
--------------------------------------------------------------------------------
1 | <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16"><g class="nc-icon-wrapper" fill="#718096"><circle data-color="color-2" cx="8" cy="7" r="3"/> <path fill="#718096" d="M8,0C3.6,0,0,3.6,0,8s3.6,8,8,8s8-3.6,8-8S12.4,0,8,0z M12,12.4c-0.6-0.7-1.4-1.4-3-1.4H7 c-1.6,0-2.4,0.7-3,1.4C2.8,11.3,2,9.8,2,8c0-3.3,2.7-6,6-6s6,2.7,6,6C14,9.8,13.2,11.3,12,12.4z"/></g></svg>


--------------------------------------------------------------------------------
/public/mix-manifest.json:
--------------------------------------------------------------------------------
1 | {
2 |     "/laravel-dashboard-template.css": "/laravel-dashboard-template.css?id=9d096b9fa18afe0046b9"
3 | }
4 | 


--------------------------------------------------------------------------------
/resources/sass/_tailwind.scss:
--------------------------------------------------------------------------------
1 | @tailwind base;
2 | @tailwind components;
3 | @tailwind utilities;
4 | 


--------------------------------------------------------------------------------
/resources/sass/app.scss:
--------------------------------------------------------------------------------
1 | @import url('https://fonts.googleapis.com/css?family=Rubik:300,400,500,700&subset=cyrillic');
2 | @import 'tailwind';
3 | 


--------------------------------------------------------------------------------
/resources/views/components/card.blade.php:
--------------------------------------------------------------------------------
 1 | <div class="ldt-rounded ldt-bg-white ldt-shadow ldt-mx-auto ldt-overflow-hidden">
 2 |     <div
 3 |       class="ldt-flex ldt-items-center ldt-justify-between ldt-px-5 ldt-py-4 ldt-bg-gray-100 ldt-border-b ldt-uppercase ldt-text-sm ldt-tracking-widest ldt-font-medium ldt-text-gray-700"
 4 |     >
 5 |       {{ $title }}
 6 |     </div>
 7 | 
 8 |     <div class="ldt-px-5 ldt-py-5 ldt-overflow-x-auto">
 9 |         {{ $slot }}
10 |     </div>
11 | </div>
12 | 


--------------------------------------------------------------------------------
/resources/views/components/dropdown.blade.php:
--------------------------------------------------------------------------------
 1 | <div class="ldt-relative group ldt-inline-block {{ $class ?? '' }}">
 2 |     <button class="ldt-flex ldt-items-center ldt-cursor-pointer ldt-text-sm">
 3 |         {{ $activator }}
 4 |         @if (trim($slot))
 5 |             @include('laravel-dashboard-template::partials.dropdown_arrow')
 6 |         @endif
 7 |     </button>
 8 | 
 9 |     @if (trim($slot))
10 |         <div class="ldt-min-w-32 ldt-right-0 ldt-items-center ldt-absolute ldt-border ldt-border-gray-400 ldt-rounded ldt-bg-white ldt-invisible group-hover:ldt-visible ldt-w-full">
11 |             {{ $slot }}
12 |         </div>
13 |     @endif
14 | </div>


--------------------------------------------------------------------------------
/resources/views/components/dropdown_item.blade.php:
--------------------------------------------------------------------------------
1 | <a href="{{ $url ?? '#' }}" @isset($id) id="{{ $id }}" @endisset @isset($onClick) onClick="{{ $onClick }}" @endisset class="ldt-px-4 ldt-py-2 ldt-block ldt-text-black hover:ldt-bg-gray-200 ldt-text-sm">
2 |     {{ $slot }}
3 | </a>


--------------------------------------------------------------------------------
/resources/views/components/topbar.blade.php:
--------------------------------------------------------------------------------
 1 | <div class="ldt-flex ldt-flex-col lg:ldt-flex-row lg:ldt-items-center ldt-items-end ldt-justify-end @if(trim($left)) lg:ldt-justify-between @endif ldt-py-4 ldt-bg-white ldt-relative ldt-shadow ldt-border-gray-400 ldt-px-5 lg:ldt-px-10 ldt-flex ldt-justify-end lg:ldt-sticky lg:ldt-top-0 ldt-mt-18 lg:ldt-mt-0">
 2 |     @if(trim($left))
 3 |         <div class="ldt-flex ldt-items-center">
 4 |             {{ $left }}
 5 |         </div>
 6 |     @endif
 7 |     <div class="ldt-flex ldt-items-center">
 8 |         {{ $right }}
 9 |         @include('laravel-dashboard-template::partials.topbar_profile_dropdown', ['class' => trim($right) ? 'ldt-ml-5 ' : ''])
10 |     </div>
11 | </div>


--------------------------------------------------------------------------------
/resources/views/page.blade.php:
--------------------------------------------------------------------------------
 1 | @inject('template', 'Sandulat\LaravelDashboardTemplate\LaravelDashboardTemplate')
 2 | 
 3 | <html lang="en">
 4 | <head>
 5 |     <meta charset="utf-8">
 6 |     <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
 7 |     <meta name="viewport" content="width=device-width, initial-scale=1">
 8 |     <title>{{ config('app.name', 'Laravel') }} - Dashboard</title>
 9 |     <link rel="shortcut icon" href="{{ asset('/vendor/laravel-dashboard-template/favicon.ico') }}">
10 |     <link rel="stylesheet" href="{{ asset(mix('laravel-dashboard-template.css', 'vendor/laravel-dashboard-template')) }}">
11 |     @yield('ldt-head')
12 | </head>
13 | <body class="ldt-bg-gray-200 ldt-font-sans ldt-h-full ldt-overflow-x-hidden ldt-w-full ldt-h-full">
14 |     <div id="app" class="ldt-flex ldt-flex-col lg:ldt-flex-row ldt-relative ldt-w-full">
15 |         @include('laravel-dashboard-template::partials.sidebar')
16 |         <main class="ldt-w-full ldt-min-h-screen">
17 |             @component('laravel-dashboard-template::components.topbar', ['template' => $template])
18 |                 @slot('left')
19 |                     @yield('ldt-topbar-left')
20 |                 @endslot
21 |                 @slot('right')
22 |                     @yield('ldt-topbar-right')
23 |                 @endslot
24 |             @endcomponent
25 |             <div class="ldt-p-5 lg:ldt-p-10 ldt-w-full">
26 |                 @if (session()->has('success'))
27 |                     @include('laravel-dashboard-template::partials.alert_success', ['message' => session()->get('success')])
28 |                 @endif
29 |                 @if (session()->has('error'))
30 |                     @include('laravel-dashboard-template::partials.alert_error', ['message' => session()->get('error')])
31 |                 @endif
32 |                 @yield('ldt-content')
33 |             </div>
34 |         </main>
35 |     </div>
36 |     @yield('ldt-scripts')
37 | </body>
38 | </html>
39 | 


--------------------------------------------------------------------------------
/resources/views/partials/alert.blade.php:
--------------------------------------------------------------------------------
1 | <div class="ldt-flex ldt-items-center ldt-justify-between ldt-mb-5 ldt-rounded ldt-bg-{{ $color }}-200 ldt-border ldt-border-{{ $color }}-400 ldt-text-{{ $color }}-900 ldt-text-sm ldt-p-4 ldt-w-full">
2 |     {{ $message }}
3 |     <button onClick="event.preventDefault(); event.target.parentNode.remove();">
4 |         <svg class="ltd-fill-current ldt-opacity-50 ldt-pointer-events-none" xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 12 12"><g class="nc-icon-wrapper" fill="currentColor"><path d="M10.707,1.293a1,1,0,0,0-1.414,0L6,4.586,2.707,1.293A1,1,0,0,0,1.293,2.707L4.586,6,1.293,9.293a1,1,0,1,0,1.414,1.414L6,7.414l3.293,3.293a1,1,0,0,0,1.414-1.414L7.414,6l3.293-3.293A1,1,0,0,0,10.707,1.293Z" fill="currentColor"/></g></svg>
5 |     </button>
6 | </div>
7 | 


--------------------------------------------------------------------------------
/resources/views/partials/alert_error.blade.php:
--------------------------------------------------------------------------------
1 | @include('laravel-dashboard-template::partials.alert', ['message' => $message, 'color' => 'pink'])
2 | 


--------------------------------------------------------------------------------
/resources/views/partials/alert_success.blade.php:
--------------------------------------------------------------------------------
1 | @include('laravel-dashboard-template::partials.alert', ['message' => $message, 'color' => 'green'])
2 | 


--------------------------------------------------------------------------------
/resources/views/partials/dropdown_arrow.blade.php:
--------------------------------------------------------------------------------
1 | <svg class="ldt-fill-current ldt-h-4 ldt-w-4 ldt-ml-1" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20"><path d="M9.293 12.95l.707.707L15.657 8l-1.414-1.414L10 10.828 5.757 6.586 4.343 8z"/></svg>


--------------------------------------------------------------------------------
/resources/views/partials/menu_toggle.blade.php:
--------------------------------------------------------------------------------
1 | <button
2 |     onClick="event.preventDefault();document.querySelectorAll('.ldt-menu-toggle-target').forEach(e => e.classList.toggle('ldt-hidden'));"
3 |     class="ldt-text-gray-500 ldt-p-2 ldt-rounded ldt-border ldt-border-gray-500 lg:ldt-hidden"
4 | >
5 |     <svg class="ldt-fill-current ldt-h-3 ldt-w-3" viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg">
6 |         <title>Menu</title>
7 |         <path d="M0 3h20v2H0V3zm0 6h20v2H0V9zm0 6h20v2H0v-2z"/>
8 |     </svg>
9 | </button>


--------------------------------------------------------------------------------
/resources/views/partials/sidebar.blade.php:
--------------------------------------------------------------------------------
 1 | <nav class="ldt-flex ldt-flex-col ldt-justify-between ldt-bg-gray-800 lg:ldt-h-full lg:ldt-min-h-screen ldt-max-h-screen ldt-overflow-y-auto ldt-p-5 ldt-fixed ldt-w-full ldt-z-10 lg:ldt-sticky lg:ldt-mt-0 ldt-top-0 lg:ldt-min-w-56 lg:ldt-max-w-56 lg:ldt-px-6 lg:ldt-py-4 ldt-overflow-y-auto">
 2 |     <div>
 3 |         <div class="ldt-flex ldt-justify-between ldt-items-center">
 4 |             @include('laravel-dashboard-template::partials.sidebar_logo')
 5 |             @include('laravel-dashboard-template::partials.menu_toggle')
 6 |         </div>
 7 |         <div class="ldt-menu-toggle-target ldt-hidden lg:ldt-block ldt-mt-10">
 8 |             @foreach($template->sidebarLinks() as $section => $links)
 9 |                 <p class="ldt-text-gray-600 ldt-uppercase ldt-font-medium ldt-tracking-widest ldt-text-xs ldt-mb-2">{{ $section }}</p>
10 |                 <ul class="ldt-text-gray-400 ldt-mb-5 lg:ldt-mb-10">
11 |                     @foreach($links as $link)
12 |                         @include('laravel-dashboard-template::partials.sidebar_link', ['link' => $link])
13 |                     @endforeach
14 |                 </ul>
15 |             @endforeach
16 |         </div>
17 |     </div>
18 |     <div class="ldt-menu-toggle-target ldt-hidden lg:ldt-block">
19 |         @yield('ldt-sidebar-footer')
20 |     </div>
21 | </nav>


--------------------------------------------------------------------------------
/resources/views/partials/sidebar_link.blade.php:
--------------------------------------------------------------------------------
 1 | <li class="ldt-py-1">
 2 |     <a href="{{ $link['url'] }}" class="hover:ldt-text-white ldt-tracking-wide">
 3 |         {{ $link['label'] }}
 4 |     </a>
 5 |     @isset($link['children'])
 6 |         <ul class="ldt-ml-5 ldt-text-gray-600 ldt-text-sm">
 7 |             @foreach($link['children'] as $childLink)
 8 |                 @include('laravel-dashboard-template::partials.sidebar_link', ['link' => $childLink])
 9 |             @endforeach
10 |         </ul>
11 |     @endisset
12 | </li>


--------------------------------------------------------------------------------
/resources/views/partials/sidebar_logo.blade.php:
--------------------------------------------------------------------------------
1 | <p class="ldt-text-white ldt-font-medium ldt-tracking-widest ldt-text-lg ldt-inline-block">
2 |     {{ config('app.name', 'Laravel') }}
3 | </p>


--------------------------------------------------------------------------------
/resources/views/partials/topbar_profile_dropdown.blade.php:
--------------------------------------------------------------------------------
 1 | @component('laravel-dashboard-template::components.dropdown', ['class' => $class ?? ''])
 2 |     @slot('activator')
 3 |         <div style="background-image: url({{ $template->userAvatar() }})" class="ldt-inline-block ldt-bg-center ldt-bg-cover ldt-rounded-full ldt-mr-2 ldt-w-6 ldt-h-6 ldt-shadow-inner"></div>
 4 |         {{ $template->userName() }}
 5 |     @endslot
 6 | 
 7 |     @foreach($template->profileDropdownLinks() as $link)
 8 |         @component('laravel-dashboard-template::components.dropdown_item', $link)
 9 |             {{ $link['label'] }}
10 |         @endcomponent
11 |     @endforeach
12 | 
13 |     @if(auth()->check())
14 |         @component('laravel-dashboard-template::components.dropdown_item', ['onClick' => 'event.preventDefault(); document.getElementById("ldt-logout-form").submit();', 'id' => 'ldt-logout-button'])
15 |             Logout
16 |         @endcomponent
17 | 
18 |         <form id="ldt-logout-form" action="{{ route('laravel-dashboard-template.logout') }}" method="POST" class="ldt-hidden">
19 |             @csrf
20 |         </form>
21 |     @endif
22 | @endcomponent


--------------------------------------------------------------------------------
/src/Console/InstallCommand.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Sandulat\LaravelDashboardTemplate\Console;
 6 | 
 7 | use Illuminate\Support\Str;
 8 | use Illuminate\Console\Command;
 9 | use Illuminate\Console\DetectsApplicationNamespace;
10 | 
11 | /**
12 |  * Credits: laravel/telescope.
13 |  */
14 | class InstallCommand extends Command
15 | {
16 |     use DetectsApplicationNamespace;
17 | 
18 |     /**
19 |      * The name and signature of the console command.
20 |      *
21 |      * @var string
22 |      */
23 |     protected $signature = 'laravel-dashboard-template:install';
24 | 
25 |     /**
26 |      * The console command description.
27 |      *
28 |      * @var string
29 |      */
30 |     protected $description = 'Install all of the dashboard resources';
31 | 
32 |     /**
33 |      * Execute the console command.
34 |      *
35 |      * @return void
36 |      */
37 |     public function handle(): void
38 |     {
39 |         $this->comment('Publishing Dashboard Service Provider...');
40 |         $this->callSilent('vendor:publish', ['--tag' => 'laravel-dashboard-template-provider']);
41 | 
42 |         $this->comment('Publishing Dashboard Assets...');
43 |         $this->callSilent('vendor:publish', ['--tag' => 'laravel-dashboard-template-assets']);
44 |         $this->registerDashboardServiceProvider();
45 | 
46 |         $this->info('Dashboard scaffolding installed successfully.');
47 |     }
48 | 
49 |     /**
50 |      * Register the dashboard service provider in the application configuration file.
51 |      *
52 |      * @return void
53 |      */
54 |     protected function registerDashboardServiceProvider(): void
55 |     {
56 |         $namespace = str_replace_last('\\', '', $this->getAppNamespace());
57 | 
58 |         $appConfig = file_get_contents(config_path('app.php'));
59 | 
60 |         if (Str::contains($appConfig, $namespace.'\\Providers\\DashboardServiceProvider::class')) {
61 |             return;
62 |         }
63 | 
64 |         $lineEndingCount = [
65 |             "\r\n" => substr_count($appConfig, "\r\n"),
66 |             "\r" => substr_count($appConfig, "\r"),
67 |             "\n" => substr_count($appConfig, "\n"),
68 |         ];
69 | 
70 |         $eol = array_keys($lineEndingCount, max($lineEndingCount))[0];
71 | 
72 |         file_put_contents(config_path('app.php'), str_replace(
73 |             "{$namespace}\\Providers\EventServiceProvider::class,".$eol,
74 |             "{$namespace}\\Providers\EventServiceProvider::class,".$eol."        {$namespace}\Providers\DashboardServiceProvider::class,".$eol,
75 |             $appConfig
76 |         ));
77 | 
78 |         file_put_contents(app_path('Providers/DashboardServiceProvider.php'), str_replace(
79 |             "namespace App\Providers;",
80 |             "namespace {$namespace}\Providers;",
81 |             file_get_contents(app_path('Providers/DashboardServiceProvider.php'))
82 |         ));
83 |     }
84 | }
85 | 


--------------------------------------------------------------------------------
/src/Console/PublishCommand.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Sandulat\LaravelDashboardTemplate\Console;
 6 | 
 7 | use Illuminate\Console\Command;
 8 | 
 9 | /**
10 |  * Credits: laravel/telescope.
11 |  */
12 | final class PublishCommand extends Command
13 | {
14 |     /**
15 |      * The name and signature of the console command.
16 |      *
17 |      * @var string
18 |      */
19 |     protected $signature = 'laravel-dashboard-template:publish {--force : Overwrite any existing files}';
20 | 
21 |     /**
22 |      * The console command description.
23 |      *
24 |      * @var string
25 |      */
26 |     protected $description = 'Publish all of the dashboard resources';
27 | 
28 |     /**
29 |      * Execute the console command.
30 |      *
31 |      * @return void
32 |      */
33 |     public function handle(): void
34 |     {
35 |         $this->call('vendor:publish', [
36 |             '--tag' => 'laravel-dashboard-template-assets',
37 |             '--force' => true,
38 |         ]);
39 |     }
40 | }
41 | 


--------------------------------------------------------------------------------
/src/Http/Controllers/LogoutController.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Sandulat\LaravelDashboardTemplate\Http\Controllers;
 6 | 
 7 | use Illuminate\Routing\Controller;
 8 | use Sandulat\LaravelDashboardTemplate\LaravelDashboardTemplate;
 9 | 
10 | final class LogoutController extends Controller
11 | {
12 |     /**
13 |      * Logout the user.
14 |      *
15 |      * @param \Sandulat\Larabels\Larabels $larabels
16 |      */
17 |     public function __invoke(LaravelDashboardTemplate $template)
18 |     {
19 |         return $template->logout();
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Http/routes.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | use Illuminate\Support\Facades\Route;
4 | 
5 | Route::post('/logout', 'LogoutController')->name('laravel-dashboard-template.logout');
6 | 


--------------------------------------------------------------------------------
/src/LaravelDashboardTemplate.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | declare(strict_types=1);
  4 | 
  5 | namespace Sandulat\LaravelDashboardTemplate;
  6 | 
  7 | use Closure;
  8 | use Illuminate\Support\Facades\URL;
  9 | use Illuminate\Support\Facades\Auth;
 10 | use Illuminate\Http\RedirectResponse;
 11 | 
 12 | final class LaravelDashboardTemplate
 13 | {
 14 |     /**
 15 |      * User name callback.
 16 |      *
 17 |      * @var Closure
 18 |      */
 19 |     private static $userName;
 20 | 
 21 |     /**
 22 |      * User avatar callback.
 23 |      *
 24 |      * @var Closure
 25 |      */
 26 |     private static $userAvatar;
 27 | 
 28 |     /**
 29 |      * Sidebar links callback.
 30 |      *
 31 |      * @var Closure
 32 |      */
 33 |     private static $sidebarLinks;
 34 | 
 35 |     /**
 36 |      * Profile dropdown links callback.
 37 |      *
 38 |      * @var Closure
 39 |      */
 40 |     private static $profileDropdownLinks;
 41 | 
 42 |     /**
 43 |      * Logout callback.
 44 |      *
 45 |      * @var Closure
 46 |      */
 47 |     private static $logout;
 48 | 
 49 |     /**
 50 |      * Logged out callback.
 51 |      *
 52 |      * @var Closure
 53 |      */
 54 |     private static $loggedOut;
 55 | 
 56 |     /**
 57 |      * Logout redirect callback.
 58 |      *
 59 |      * @var Closure
 60 |      */
 61 |     private static $logoutRedirect;
 62 | 
 63 |     /**
 64 |      * Set the user name callback.
 65 |      *
 66 |      * @param \Closure $callback
 67 |      * @return void
 68 |      */
 69 |     public static function setUserName(Closure $callback): void
 70 |     {
 71 |         static::$userName = $callback;
 72 |     }
 73 | 
 74 |     /**
 75 |      * Set the user avatar callback.
 76 |      *
 77 |      * @param \Closure $callback
 78 |      * @return void
 79 |      */
 80 |     public static function setUserAvatar(Closure $callback): void
 81 |     {
 82 |         static::$userAvatar = $callback;
 83 |     }
 84 | 
 85 |     /**
 86 |      * Set the sidebar links callback.
 87 |      *
 88 |      * @param \Closure $callback
 89 |      * @return void
 90 |      */
 91 |     public static function setSidebarLinks(Closure $callback): void
 92 |     {
 93 |         static::$sidebarLinks = $callback;
 94 |     }
 95 | 
 96 |     /**
 97 |      * Set the profile dropdown links callback.
 98 |      *
 99 |      * @param \Closure $callback
100 |      * @return void
101 |      */
102 |     public static function setProfileDropdownLinks(Closure $callback): void
103 |     {
104 |         static::$profileDropdownLinks = $callback;
105 |     }
106 | 
107 |     /**
108 |      * Set the logout callback.
109 |      *
110 |      * @param \Closure $callback
111 |      * @return void
112 |      */
113 |     public static function setLogout(Closure $callback): void
114 |     {
115 |         static::$logout = $callback;
116 |     }
117 | 
118 |     /**
119 |      * Set the logged out callback.
120 |      *
121 |      * @param \Closure $callback
122 |      * @return void
123 |      */
124 |     public static function setLoggedOut(Closure $callback): void
125 |     {
126 |         static::$loggedOut = $callback;
127 |     }
128 | 
129 |     /**
130 |      * Set the logout redirect callback.
131 |      *
132 |      * @param \Closure $callback
133 |      * @return void
134 |      */
135 |     public static function setLogoutRedirect(Closure $callback): void
136 |     {
137 |         static::$logoutRedirect = $callback;
138 |     }
139 | 
140 |     /**
141 |      * Get the user name.
142 |      *
143 |      * @return string
144 |      */
145 |     public function userName(): string
146 |     {
147 |         return (static::$userName ?? function () {
148 |             return Auth::check() ? Auth::user()->name : 'Guest';
149 |         })();
150 |     }
151 | 
152 |     /**
153 |      * Get the user avatar.
154 |      *
155 |      * @return string
156 |      */
157 |     public function userAvatar(): string
158 |     {
159 |         return (static::$userAvatar ?? function () {
160 |             return URL::asset('/vendor/laravel-dashboard-template/images/avatar.svg');
161 |         })();
162 |     }
163 | 
164 |     /**
165 |      * Get the sidebar links.
166 |      *
167 |      * @return array
168 |      */
169 |     public function sidebarLinks(): array
170 |     {
171 |         return (static::$sidebarLinks ?? function () {
172 |             return [
173 |                 'Menu' => [
174 |                     [
175 |                         'label' => 'Home',
176 |                         'url' => '/',
177 |                     ],
178 |                 ],
179 |             ];
180 |         })();
181 |     }
182 | 
183 |     /**
184 |      * Get the profile dropdown links.
185 |      *
186 |      * @return array
187 |      */
188 |     public function profileDropdownLinks(): array
189 |     {
190 |         return (static::$profileDropdownLinks ?? function () {
191 |             return [];
192 |         })();
193 |     }
194 | 
195 |     /**
196 |      * Logout the user.
197 |      *
198 |      * @return \Illuminate\Http\RedirectResponse
199 |      */
200 |     public function logout(): RedirectResponse
201 |     {
202 |         (static::$logout ?? function () {
203 |             Auth::guard()->logout();
204 | 
205 |             request()->session()->invalidate();
206 |         })();
207 | 
208 |         $this->loggedOut();
209 | 
210 |         return $this->logoutRedirect();
211 |     }
212 | 
213 |     /**
214 |      * The user has logged out of the application.
215 |      *
216 |      * @return void
217 |      */
218 |     public function loggedOut(): void
219 |     {
220 |         (static::$loggedOut ?? function () {
221 |             //
222 |         })();
223 |     }
224 | 
225 |     /**
226 |      * Redirect after logout.
227 |      *
228 |      * @return \Illuminate\Http\RedirectResponse
229 |      */
230 |     public function logoutRedirect(): RedirectResponse
231 |     {
232 |         return (static::$logoutRedirect ?? function () {
233 |             return redirect('/');
234 |         })();
235 |     }
236 | }
237 | 


--------------------------------------------------------------------------------
/src/LaravelDashboardTemplateApplicationServiceProvider.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Sandulat\LaravelDashboardTemplate;
 6 | 
 7 | use Illuminate\Support\ServiceProvider;
 8 | 
 9 | /**
10 |  * @method string userName() User name resolver.
11 |  * @method string userAvatar() User avatar resolver.
12 |  * @method string sidebarLinks() Sidebar links.
13 |  * @method array profileDropdownLinks() Profile dropdown links.
14 |  * @method \Illuminate\Http\RedirectResponse logoutRedirect() Redirect after logout.
15 |  * @method void loggedOut() Take action after logout.
16 |  * @method void logout() Logout the user.
17 |  */
18 | class LaravelDashboardTemplateApplicationServiceProvider extends ServiceProvider
19 | {
20 |     /**
21 |      * Bootstrap any application services.
22 |      *
23 |      * @return void
24 |      */
25 |     public function boot(): void
26 |     {
27 |         foreach ([
28 |             'userName',
29 |             'userAvatar',
30 |             'sidebarLinks',
31 |             'profileDropdownLinks',
32 |             'logoutRedirect',
33 |             'loggedOut',
34 |             'logout',
35 |         ] as $method) {
36 |             if (method_exists($this, $method)) {
37 |                 LaravelDashboardTemplate::{'set'.ucfirst($method)}(function () use ($method) {
38 |                     return $this->app->call([$this, $method]);
39 |                 });
40 |             }
41 |         }
42 |     }
43 | }
44 | 


--------------------------------------------------------------------------------
/src/LaravelDashboardTemplateFacade.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Sandulat\LaravelDashboardTemplate;
 6 | 
 7 | use Illuminate\Support\Facades\Facade;
 8 | 
 9 | /**
10 |  * @see \Sandulat\LaravelDashboardTemplate\Skeleton\SkeletonClass
11 |  */
12 | final class LaravelDashboardTemplateFacade extends Facade
13 | {
14 |     /**
15 |      * Get the registered name of the component.
16 |      *
17 |      * @return string
18 |      */
19 |     protected static function getFacadeAccessor(): string
20 |     {
21 |         return 'laravel-dashboard-template';
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/LaravelDashboardTemplateServiceProvider.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Sandulat\LaravelDashboardTemplate;
 6 | 
 7 | use Illuminate\Support\Facades\Route;
 8 | use Illuminate\Support\ServiceProvider;
 9 | 
10 | final class LaravelDashboardTemplateServiceProvider extends ServiceProvider
11 | {
12 |     /**
13 |      * Bootstrap the application services.
14 |      */
15 |     public function boot(): void
16 |     {
17 |         $this->registerRoutes();
18 | 
19 |         $this->loadViewsFrom(__DIR__.'/../resources/views', 'laravel-dashboard-template');
20 | 
21 |         if ($this->app->runningInConsole()) {
22 |             $this->publishes([
23 |                 __DIR__.'/../resources/views' => resource_path('views/vendor/laravel-dashboard-template'),
24 |             ], 'laravel-dashboard-template-views');
25 | 
26 |             $this->publishes([
27 |                 __DIR__.'/../public' => public_path('vendor/laravel-dashboard-template'),
28 |             ], 'laravel-dashboard-template-assets');
29 | 
30 |             $this->publishes([
31 |                 __DIR__.'/../stubs/LaravelDashboardTemplateServiceProvider.stub' => app_path('Providers/DashboardServiceProvider.php'),
32 |             ], 'laravel-dashboard-template-provider');
33 |         }
34 |     }
35 | 
36 |     /**
37 |      * Register the application services.
38 |      */
39 |     public function register(): void
40 |     {
41 |         $this->commands([
42 |             Console\InstallCommand::class,
43 |             Console\PublishCommand::class,
44 |         ]);
45 | 
46 |         $this->app->singleton('laravel-dashboard-template', function () {
47 |             return new LaravelDashboardTemplate;
48 |         });
49 |     }
50 | 
51 |     /**
52 |      * Register the package routes.
53 |      *
54 |      * @return void
55 |      */
56 |     private function registerRoutes(): void
57 |     {
58 |         Route::group($this->routeConfiguration(), function () {
59 |             $this->loadRoutesFrom(__DIR__.'/Http/routes.php');
60 |         });
61 |     }
62 | 
63 |     /**
64 |      * Get the main route group configuration array.
65 |      *
66 |      * @return array
67 |      */
68 |     private function routeConfiguration(): array
69 |     {
70 |         return [
71 |             'namespace' => 'Sandulat\LaravelDashboardTemplate\Http\Controllers',
72 |             'prefix' => 'laravel-dashboard-template',
73 |             'middleware' => 'web',
74 |         ];
75 |     }
76 | }
77 | 


--------------------------------------------------------------------------------
/stubs/LaravelDashboardTemplateServiceProvider.stub:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace App\Providers;
 6 | 
 7 | use Sandulat\LaravelDashboardTemplate\LaravelDashboardTemplateApplicationServiceProvider;
 8 | 
 9 | final class DashboardServiceProvider extends LaravelDashboardTemplateApplicationServiceProvider
10 | {
11 |     //
12 | }
13 | 


--------------------------------------------------------------------------------
/tailwind.config.js:
--------------------------------------------------------------------------------
 1 | module.exports = {
 2 |   theme: {
 3 |     extend: {
 4 |       minWidth: {
 5 |         '32': '8rem',
 6 |         '56': '14rem'
 7 |       },
 8 |       maxWidth: {
 9 |         '56': '14rem'
10 |       },
11 |       spacing: {
12 |         '18': '4.5rem',
13 |       },
14 |       fontFamily: {
15 |         sans: 'Rubik, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"'
16 |       }
17 |     },
18 |   },
19 |   variants: {
20 |     visibility: ['responsive', 'group-hover']
21 |   },
22 |   plugins: [],
23 |   prefix: 'ldt-',
24 | }
25 | 


--------------------------------------------------------------------------------
/webpack.mix.js:
--------------------------------------------------------------------------------
 1 | const path = require('path');
 2 | const mix = require('laravel-mix');
 3 | const webpack = require('webpack');
 4 | const tailwindcss = require('tailwindcss');
 5 | require('laravel-mix-purgecss');
 6 | 
 7 | /*
 8 |  |--------------------------------------------------------------------------
 9 |  | Mix Asset Management
10 |  |--------------------------------------------------------------------------
11 |  |
12 |  | Mix provides a clean, fluent API for defining some Webpack build steps
13 |  | for your Laravel application. By default, we are compiling the Sass
14 |  | file for the application as well as bundling up all the JS files.
15 |  |
16 |  */
17 | 
18 | mix.options({
19 |   uglify: {
20 |     uglifyOptions: {
21 |       compress: {
22 |         drop_console: true,
23 |       },
24 |     },
25 |   },
26 | })
27 |   .setPublicPath('public')
28 |   .sass('resources/sass/app.scss', 'public/laravel-dashboard-template.css')
29 |   .options({
30 |     processCssUrls: false,
31 |     postCss: [tailwindcss('./tailwind.config.js')],
32 |   })
33 |   .version();
34 |   // .purgeCss();


--------------------------------------------------------------------------------