Add theming support to your Laravel 5.* projects

v1.0.5 2019-04-27 11:26 UTC

This package is auto-updated.

Last update: 2024-07-13 03:07:43 UTC


Build Status Latest Stable Version License

Add theming support to your Laravel 5.* projects.


  • Custom theme locations
  • Support for theme inheritence with theme fallback
  • Theme assets loading
  • Artisan console commands


Require it via terminal like so:

$ composer require karlomikus/theme

Or add the package to your composer file:

"karlomikus/theme": "1.*"

Next add new service provider and facade to your config/app.php file:

// Service provider
// Facade
'Theme' => Karlomikus\Theme\Facade\Theme::class

Next you need to publish the config file:

$ php artisan vendor:publish

This will create a theme.php file in your config directory in which you can define your default path to themes directory.

Theme setup

Create new folder in your themes directory (default: public/themes) and add views folder (which will hold all your custom views) and theme.json file (contains information about a theme).

    "name": "Theme name",
    "author": "Karlo Mikuš",
    "description": "Default theme description",
    "version": "1.0",
    "namespace": "theme-folder",
    "parent": null

This are all available attributes, but the required ones only include: name, author and namespace. Value of namespace must be the name of the theme's folder.

If you want your theme to depend on other theme views, just include a parent theme namespace in parent attribute.

Example folder structure:

- public/
    - themes/
        - theme-1/
            - views/
            - theme.json


The library will firstly check all available valid themes in theme directory.

You can then set a theme by it's namespace:


Then you call views like you usually do in laravel:


This will firstly check if there is a home.blade.php in current theme directory. If none is found then it checks parent theme, and finally falls back to default laravel views location.

You can also inject theme instance using ThemeInterface.

use Karlomikus\Theme\Contracts\ThemeInterface;

private $theme;

public function __construct(ThemeInterface $theme)
    $this->theme = $theme

Theme path

You can set default path to themes folder in config/theme.php file. Please note that currently themes folder must be somewhere inside public folder.

Available methods

Here's the list of methods you can access:

// Activate/set theme

// Get all available themes as an array

// Get currently active

// Get theme by namespace

// Override default theme path

// Check if theme exists

// Render theme path URL

Artisan commands

Get a table of all found themes:

$ php artisan theme:list

| Name             | Author      | Namespace  |
| Bootstrap theme  | Karlo Mikus | bootstrap  |
| Default theme    | Test Author | default    |
| Foundation theme | Lorem Ipsum | foundation |
| Test theme       | Dolor Sitha | test       |

Create a theme directory with config file:

$ php artisan theme:make

 Template name:
 > Theme name

 Template author:
 > Firstn Lastn

Theme created succesfully!


Please see CHANGELOG for more information what has changed recently.


  • Contact me for ideas