PHPackages                             mekad/laravel-theme-customizer - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. mekad/laravel-theme-customizer

ActiveLibrary[Utility & Helpers](/categories/utility)

mekad/laravel-theme-customizer
==============================

A Laravel package for theme customization with TailwindCSS and Bootstrap support

1.0.0(1y ago)014MITPHP

Since Apr 15Pushed 1y ago1 watchersCompare

[ Source](https://github.com/mekadalibrahem/laravel-theme-customizer)[ Packagist](https://packagist.org/packages/mekad/laravel-theme-customizer)[ RSS](/packages/mekad-laravel-theme-customizer/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (1)Versions (5)Used By (0)

Laravel Theme Customizer
========================

[](#laravel-theme-customizer)

A Laravel package that allows you to customize your application's theme colors and settings.

Features
--------

[](#features)

- Global and user-specific theme customization
- Color picker for primary, secondary, and accent colors
- Light and dark mode support
- Role-based access control for theme management
- Default themes included
- Easy installation and setup
- Real-time theme preview
- Professional theme editor interface

Installation
------------

[](#installation)

1. Install the package via Composer:

```
composer require mekad/laravel-theme-customizer
```

2. Publish the package assets:

```
php artisan vendor:publish --provider="Mekad\LaravelThemeCustomizer\ThemeCustomizerServiceProvider"
```

3. Run the installation command:

```
php artisan theme-customizer:install
```

This will:

- Run the necessary migrations
- Seed the database with default themes
- Set up the required configuration

Default Themes
--------------

[](#default-themes)

The package comes with three pre-configured global themes:

1. **Dark Blue & Green** (Active by default)

    - Primary: #1a3a6c
    - Secondary: #1e4d45
    - Light Primary: #2c5eaa
    - Light Secondary: #2a6b5f
    - Accent: #ffc107
    - Text Light: #f8f9fa
    - Text Dark: #343a40
    - Dark Background: #1a1a24
2. **Light Blue & Green**

    - Primary: #3490dc
    - Secondary: #38a169
    - Light Primary: #6cb2eb
    - Light Secondary: #68d391
    - Accent: #f6ad55
    - Text Light: #ffffff
    - Text Dark: #1a202c
    - Dark Background: #2d3748
3. **Purple & Teal**

    - Primary: #6b46c1
    - Secondary: #319795
    - Light Primary: #9f7aea
    - Light Secondary: #4fd1c5
    - Accent: #f687b3
    - Text Light: #ffffff
    - Text Dark: #1a202c
    - Dark Background: #2d3748

Configuration
-------------

[](#configuration)

After installation, you can configure the package by editing the `config/theme-customizer.php` file. The main configuration options are:

```
return [
    'theme_mode' => 'admin', // 'admin' or 'user'
    'roles' => [
        'enabled' => true,
        'admin_role' => 'admin',
    ],
    'default_colors' => [
        'primary_color' => '#1a3a6c',
        'secondary_color' => '#1e4d45',
        'light_primary' => '#2c5eaa',
        'light_secondary' => '#2a6b5f',
        'accent_color' => '#ffc107',
        'text_light' => '#f8f9fa',
        'text_dark' => '#343a40',
        'dark_background' => '#1a1a24',
    ],
];
```

Usage
-----

[](#usage)

### Middleware Setup

[](#middleware-setup)

The package includes a middleware that needs to be registered. You can add it to your application's middleware stack by using its class name:

```
\Mekad\LaravelThemeCustomizer\Http\Middleware\ThemeMiddleware::class
```

add Theme Midllwere for your Midllwere (if don't add it nothing will work)

### Blade Components

[](#blade-components)

Use the provided Blade components to apply themes to your views:

```

```

To add the theme editor for managing themes:

```

```

The theme editor provides:

- Theme selection and creation
- Color customization with real-time preview
- Set active theme functionality
- Theme deletion (non-active themes only)
- Preview of theme in different contexts (navigation, cards, dark mode)

### Theme Management

[](#theme-management)

Access the theme management interface at `/theme-customizer` (requires admin role if theme\_mode is set to 'admin').

#### Available Actions

[](#available-actions)

- Create/Update themes
- Set active theme
- Delete themes (cannot delete active theme)
- Preview theme changes in real-time
- Reset to default colors
- View theme in different contexts

Requirements
------------

[](#requirements)

- PHP >= 8.1
- Laravel >= 9.0
- Composer

License
-------

[](#license)

This package is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).

Support
-------

[](#support)

If you find a bug or have a feature request, please open an issue on the [GitHub repository](https://github.com/mekadalibrahem/laravel-theme-customizer).

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance48

Moderate activity, may be stable

Popularity6

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity40

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~2 days

Total

4

Last Release

383d ago

Major Versions

0.0.4.53 → 1.0.02025-04-22

### Community

Maintainers

![](https://www.gravatar.com/avatar/ace2a79e55101edcf9b32d4436ae884500813528c6271e1db242324785d83cbf?d=identicon)[mekadalibrahem](/maintainers/mekadalibrahem)

---

Top Contributors

[![mekadalibrahem](https://avatars.githubusercontent.com/u/79482795?v=4)](https://github.com/mekadalibrahem "mekadalibrahem (22 commits)")

### Embed Badge

![Health badge](/badges/mekad-laravel-theme-customizer/health.svg)

```
[![Health](https://phpackages.com/badges/mekad-laravel-theme-customizer/health.svg)](https://phpackages.com/packages/mekad-laravel-theme-customizer)
```

###  Alternatives

[happy-types/enumerable-type

Strongly typed implementation of enumerable type in PHP which helps us to write a safer more readable code.

4742.6k](/packages/happy-types-enumerable-type)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)