backpack/theme-coreuiv4

UI for Backpack v6 that uses CoreUI v4 and Bootstrap v5.

1.1.4 2024-10-17 15:49 UTC

README

Latest Version on Packagist Total Downloads The Whole Fruit Manifesto

This package provides a Theme for the Backpack for Laravel administration panel, that uses CoreUI v4 and implicitly Bootstrap v5. All esthetic customizations on top of CoreUI are done in separate CSS files, which can be easily edited if you don't like them.

The file structure inside this package is the same as CoreUI v2, which is the same as Backpack v3, v4 and v5. If you want to upgrade to Bootstrap v5 and a modern theme, but you've heavily customized your blade files... this theme will be the easiest to upgrade to.

Screenshots

CleanShot 2023-06-30 at 18 18 43

Installing

Automatic installation

Because this a 1st party theme, you can quickly install it using

php artisan backpack:require:theme-coreuiv4

Alternatively, follow the manual installation process below.

Manual installation

Step 1. Install via Composer

composer require backpack/theme-coreuiv4

Step 2. Go to config/backpack/ui.php and change your view namespace:

-    'view_namespace' => 'backpack::',
+    'view_namespace' => 'backpack.theme-coreuiv4::',

Step 3. (Optional) Publish the theme config file:

php artisan vendor:publish --tag="theme-coreuiv4-config"

Uninstalling

To uninstall this Backpack theme:

  1. Remove the composer package. Eg. composer remove backpack/theme-coreuiv4
  2. Delete the config file. Eg. rm -rf config/backpack/theme-coreuiv4.php
  3. Install a new theme (eg. php artisan backpack:require:theme-tabler) or change the view_namespace in config/backpack/ui.php to the theme you want to be active.

Overriding

If you need to change a blade file in any way, you can easily copy-paste the file to your app, and modify that file any way you want. If you do that to the correct directory, your file will be used instead of the one in the package. But please keep in mind that you will NOT be getting any updates for that file.

The more files you copy-paste and customize, the more difficult it will be to upgrade to newer versions. So please avoid doing this too much.

# create the custom directory if it's not already there
mkdir -p resources/views/vendor/backpack/theme-coreuiv4

# copy the blade file inside the folder we created above
cp -i vendor/backpack/theme-coreuiv4/src/resources/views/dashboard.blade.php resources/views/vendor/backpack/theme-coreuiv4/dashboard.blade.php

Change log

Changes are documented here on Github. Please see the Releases tab.

Contributing

Please see contributing.md for a todolist and howtos.

Security

If you discover any security related issues, please email hello@backpackforlaravel.com instead of using the issue tracker.

Credits

License

This project was released under MIT, so you can install it on top of any Backpack & Laravel project. Please see the license file for more information.