# Change theme
To change the theme, you can use the BOILERPLATE_THEME
environment variable in your .env
file or define it directly in the config/theme.php
file.
# Method 1: Environment Variable (Recommended)
Add the theme name to your .env
file:
BOILERPLATE_THEME=black
# Method 2: Direct Configuration
You can also manually modify the theme in your config/boilerplate/theme.php
file:
// Selected theme
$selectedTheme = env('BOILERPLATE_THEME', 'red'); // Change default here
// Check if theme exists
$themePath = __DIR__.'/themes/'.$selectedTheme.'.php';
if (!file_exists($themePath)) {
$selectedTheme = 'default';
$themePath = __DIR__.'/themes/default.php';
}
$theme = include $themePath;
Available themes are
default
,black
,red
. The system automatically validates theme existence and falls back to default if the specified theme is not found.
# Create a new theme
You don't have to create a new theme, you can also edit the default
theme. But it is recommended to create a new theme, so you can add modifications without touching the default themes.
To create a new theme:
- Copy the
default.php
file in theconfig/boilerplate/themes/
folder to a new theme file (e.g.,custom.php
) - Modify your new theme file as needed
- Set the
BOILERPLATE_THEME
environment variable to your new theme name:
BOILERPLATE_THEME=custom
The system will automatically load your custom theme. If the theme file doesn't exist, it will fallback to the default theme.
# Application icon (logo) and display name
To change the application icon and the display name, just change the sidebar/brand/logo/icon
and sidebar/brand/logo/text
in the current theme file.
'sidebar' => [
'brand' => [
'logo' => [
'bg' => 'blue',
'icon' => '<i class="fa fa-cubes"></i>',
'text' => '<strong>BO</strong>ilerplate',
'shadow' => 2,
],
]
]
You can use Font Awesome (opens new window) icons for you logo.