Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ivanaquino/laravel-taildashboards
This Laravel package provides an effortless way to implement beautiful and responsive dashboard templates from https://taildashboards.com
https://github.com/ivanaquino/laravel-taildashboards
composer dashboard dashboard-template laravel laravel-framework laravel-package tailwind tailwindcss
Last synced: 7 days ago
JSON representation
This Laravel package provides an effortless way to implement beautiful and responsive dashboard templates from https://taildashboards.com
- Host: GitHub
- URL: https://github.com/ivanaquino/laravel-taildashboards
- Owner: IvanAquino
- License: mit
- Created: 2023-08-20T03:51:36.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-10-09T12:26:36.000Z (about 1 year ago)
- Last Synced: 2024-04-28T01:39:15.579Z (7 months ago)
- Topics: composer, dashboard, dashboard-template, laravel, laravel-framework, laravel-package, tailwind, tailwindcss
- Language: Blade
- Homepage:
- Size: 137 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# laravel-taildashboards
[](https://packagist.org/packages/ivanaquino/laravel-taildashboards)
[](https://github.com/ivanaquino/laravel-taildashboards/actions?query=workflow%3Arun-tests+branch%3Amain)
[](https://github.com/ivanaquino/laravel-taildashboards/actions?query=workflow%3A"Fix+PHP+code+style+issues"+branch%3Amain)
[](https://packagist.org/packages/ivanaquino/laravel-taildashboards)
This Laravel package provides an effortless way to implement beautiful and responsive dashboard templates from [Taildashboards](https://taildashboards.com). Taildashboards offers a collection of pre-designed templates built with Tailwind CSS, and this package helps you to incorporate them into your Laravel application with ease.This is where your description should go. Limit it to a paragraph or two. Consider adding a small example.
## Installation
You can install the package via composer:
```bash
composer require ivanaquino/laravel-taildashboards
```
You need tailwind installation on your laravel, if you're using jetstream or breeze you have it installed but if not you can follow the [official tailwindcss guide](https://tailwindcss.com/docs/guides/laravel)
You will need the npm package **@tailwindcss/typography**, and add the font config to your tailwind.config.js
```js
export default {
theme: {
extend: {
fontFamily: {
sans: ["Figtree", ...defaultTheme.fontFamily.sans],
},
},
},
plugins: [require("@tailwindcss/typography")],
};
```
If you're having problems with broken styles you can add this line into tailwind.config.js
```js
export default {
content: [
// ...
"./vendor/ivanaquino/laravel-taildashboards/resources/views/**/*.blade.php",
// ...
],
};
```
You can publish the config file with:
```bash
php artisan vendor:publish --tag="taildashboards-config"
```
In this file you'll be able to edit the menu for the dashboard
```php
'menu' => [
[
'label' => 'Dashboard',
'route' => 'dashboard',
'active_route' => 'dashboard',
'icon' => 'home',
],
[
'label' => 'View 1',
'route' => 'view-1',
'active_route' => 'view-1',
'icon' => 'circle',
],
[
'label' => 'View 2',
'route' => 'view-2',
'active_route' => 'view-2',
'icon' => 'home',
],
],
```
Optionally, you can publish the views using
```bash
php artisan vendor:publish --tag="laravel-taildashboards-views"
```
## Usage
```php
# As blade layout
@extends('laravel-taildashboards::layouts.tailapp')
@section('content')
Lorem ipsum dolor sit amet consectetur adipisicing elit.
@endsection
# Or as a component layout
Lorem, ipsum dolor sit amet consectetur
```
#### Availables
```php
@extends('laravel-taildashboards::layouts.tailapp')
@extends('laravel-taildashboards::layouts.tailism')
```
# Roadmap
- [x] [TailApp](https://taildashboards.com/get/tailapp)
- [ ] [TailTube](https://taildashboards.com/get/tailtube)
- [ ] [TailFlix](https://taildashboards.com/get/tailflix)
- [x] [TailLism](https://taildashboards.com/get/tailism)
- [ ] [TailAdmin](https://taildashboards.com/get/tailadmin)
- [ ] [TailSocial](https://taildashboards.com/get/tailsocial)
- [ ] Custom components for each dashboard
- [ ] Test suit
## Testing
```bash
composer test
```
## Changelog
Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.
## Contributing
Please see [CONTRIBUTING](CONTRIBUTING.md) for details.
## Security Vulnerabilities
Please review [our security policy](../../security/policy) on how to report security vulnerabilities.
## Credits
- [Ivan Aquino](https://github.com/IvanAquino)
- [All Contributors](../../contributors)
## License
The MIT License (MIT). Please see [License File](LICENSE.md) for more information.