What are the differences between CoreUI v2 and CoreUI v4?

composer.json

@@ -1,17 +1,27 @@
 {
-    "name": "backpack/theme-coreuiv2",
-    "description": "UI that uses CoreUI v2 and Bootstrap v4, provided as a legacy theme for Backpack v6.",
+    "name": "backpack/theme-coreuiv4",
+    "description": "UI for Backpack v6 that uses CoreUI v4 and Bootstrap v5.",
     "license": "MIT",
     "authors": [
         {
             "name": "Cristian Tabacitu",
             "email": "[email protected]",
             "homepage": "https://backpackforlaravel.com"
+        },
+        {
+            "name": "Antonio Almeida",
+            "email": "[email protected]",
+            "homepage": "https://backpackforlaravel.com"
+        },
+        {
+            "name": "Mauro Martinez",
+            "email": "[email protected]",
+            "homepage": "https://backpackforlaravel.com"
         }
     ],
-    "homepage": "https://github.com/backpack/theme-coreuiv2",
+    "homepage": "https://github.com/backpack/theme-coreuiv4",
     "keywords": [
-        "Laravel", "Backpack", "Backpack for Laravel", "Backpack Addon", "ThemeCoreuiv2"
+        "Laravel", "Backpack", "Backpack for Laravel", "Backpack Addon", "ThemeCoreuiv4"
     ],
     "require": {
         "illuminate/support": "~8|~9",
@@ -23,12 +33,12 @@
     },
     "autoload": {
         "psr-4": {
-            "Backpack\\ThemeCoreuiv2\\": "src/"
+            "Backpack\\ThemeCoreuiv4\\": "src/"
         }
     },
     "autoload-dev": {
         "psr-4": {
-            "Backpack\\ThemeCoreuiv2\\Tests\\": "tests"
+            "Backpack\\ThemeCoreuiv4\\Tests\\": "tests"
         }
     },
     "scripts": {
@@ -37,7 +47,7 @@
     "extra": {
         "laravel": {
             "providers": [
-                "Backpack\\ThemeCoreuiv2\\AddonServiceProvider"
+                "Backpack\\ThemeCoreuiv4\\AddonServiceProvider"
             ]
         }
     }

config/theme-coreuiv4.php

@@ -0,0 +1,42 @@
+<?php
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Theme Configuration Values
+    |--------------------------------------------------------------------------
+    |
+    | The file provides extra configs on top of config/backpack/ui.php
+    |
+    | Any value set here will override the ones defined in
+    | config/backpack/ui.php when this theme is in use.
+    |
+    */
+
+    // -------
+    // CLASSES
+    // -------
+
+    // These can help make the admin panel look similar to your project's design.
+    'classes' => [
+
+        'header' => 'app-header bg-light border-0 navbar',
+        // For background colors use: bg-dark, bg-primary, bg-secondary, bg-danger, bg-warning, bg-success, bg-info, bg-blue, bg-light-blue, bg-indigo, bg-purple, bg-pink, bg-red, bg-orange, bg-yellow, bg-green, bg-teal, bg-cyan, bg-white
+        // For links to be visible on different background colors use: "navbar-dark", "navbar-light", "navbar-color"
+
+        'body' => 'app aside-menu-fixed sidebar-lg-show',
+        // Try sidebar-hidden, sidebar-fixed, sidebar-compact, sidebar-lg-show
+
+        'sidebar' => 'sidebar sidebar-pills bg-light',
+        // Remove "sidebar-transparent" for standard sidebar look
+        // Try "sidebar-light" or "sidebar-dark" for dark/light links
+        // You can also add a background class like bg-dark, bg-primary, bg-secondary, bg-danger, bg-warning, bg-success, bg-info, bg-blue, bg-light-blue, bg-indigo, bg-purple, bg-pink, bg-red, bg-orange, bg-yellow, bg-green, bg-teal, bg-cyan
+
+        'footer' => 'app-footer d-print-none',
+        // hide it with d-none
+        // change background color with bg-dark, bg-primary, bg-secondary, bg-danger, bg-warning, bg-success, bg-info, bg-blue, bg-light-blue, bg-indigo, bg-purple, bg-pink, bg-red, bg-orange, bg-yellow, bg-green, bg-teal, bg-cyan, bg-white
+
+    ]
+
+];

readme.md

@@ -1,18 +1,12 @@
-# Theme CoreUI v2
+# Theme CoreUI v4
 
 [![Latest Version on Packagist][ico-version]][link-packagist]
 [![Total Downloads][ico-downloads]][link-downloads]
 [![The Whole Fruit Manifesto](https://img.shields.io/badge/writing%20standard-the%20whole%20fruit-brightgreen)](https://github.com/the-whole-fruit/manifesto)
 
-This package provides a Theme for the [Backpack for Laravel](https://backpackforlaravel.com/) administration panel, that uses CoreUI v2 and implicitly Bootstrap v4. As a UI (aka UI kit, aka admin panel template) it looks and works as seen on https://backstrap.net/ - as it is a customized version of CoreUI v2.
+This package provides a Theme for the [Backpack for Laravel](https://backpackforlaravel.com/) administration panel, that uses [CoreUI v4](https://coreui.io/product/free-bootstrap-admin-template/) 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.
 
-It has been launched in 2021 as part of Backpack's core. In 2023 it has been sparated into this package, as a way to provide 100% backwards-compatibility, for whoever doesn't want to upgrade to the newer themes, like CoreUI v4 and Tabler.
-
-Why would anybody NOT want to upgrade? Well... because some developers:
-- have to support IE; and while Bootstrap v5 is better in every way... it does drop support for IE;
-- have customized their blade files so much, that it's impossible to upgrade;
-
-If you're one of the developers above, fear not... this package offers a way for you to upgrade your project to Backpack v6... while not rocking the boat too much. Please keep in mind we DO NOT plan to add any more features to this theme. It's just here as a crutch for people who can't upgrade.
+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
 
@@ -24,14 +18,14 @@ If you're one of the developers above, fear not... this package offers a way for
 **Step 1.** Install via Composer
 
 ``` bash
-composer require backpack/theme-coreuiv2
+composer require backpack/theme-coreuiv4
 ```
 
 **Step 2.** Go to `config/backpack/base.php` and change your view namespace:
 
 ```diff
 -    'view_namespace' => 'backpack::',
-+    'view_namespace' => 'backpack.theme-coreuiv2::',
++    'view_namespace' => 'backpack.theme-coreuiv4::',
 ```
 
 ## Overriding
@@ -42,15 +36,15 @@ The more files you copy-paste and customize, the more difficult it will be to up
 
 ```bash
 # create the custom directory if it's not already there
-mkdir -p resources/views/vendor/backpack/theme-coreuiv2
+mkdir -p resources/views/vendor/backpack/theme-coreuiv4
 
 # copy the blade file inside the folder we created above
-cp -i vendor/backpack/theme-coreuiv2/src/resources/views/dashboard.blade.php resources/views/vendor/backpack/theme-coreuiv2/dashboard.blade.php
+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](https://github.com/backpack/theme-coreuiv2/releases).
+Changes are documented here on Github. Please see the [Releases tab](https://github.com/backpack/theme-coreuiv4/releases).
 
 ## Contributing
 
@@ -69,10 +63,10 @@ If you discover any security related issues, please email hello@backpackforlarav
 
 This project was released under MIT, so you can install it on top of any Backpack & Laravel project. Please see the [license file](license.md) for more information.
 
-[ico-version]: https://img.shields.io/packagist/v/backpack/theme-coreuiv2.svg?style=flat-square
-[ico-downloads]: https://img.shields.io/packagist/dt/backpack/theme-coreuiv2.svg?style=flat-square
+[ico-version]: https://img.shields.io/packagist/v/backpack/theme-coreuiv4.svg?style=flat-square
+[ico-downloads]: https://img.shields.io/packagist/dt/backpack/theme-coreuiv4.svg?style=flat-square
 
-[link-packagist]: https://packagist.org/packages/backpack/theme-coreuiv2
-[link-downloads]: https://packagist.org/packages/backpack/theme-coreuiv2
+[link-packagist]: https://packagist.org/packages/backpack/theme-coreuiv4
+[link-downloads]: https://packagist.org/packages/backpack/theme-coreuiv4
 [link-author]: https://github.com/backpack
 [link-contributors]: ../../contributors