PHPackages                             awcodes/dimmer - 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. [Templating &amp; Views](/categories/templating)
4. /
5. awcodes/dimmer

ActiveLibrary[Templating &amp; Views](/categories/templating)

awcodes/dimmer
==============

Dimmer is a simple package to easily add a light/dark/system mode switcher to your Laravel app.

v1.2.0(1y ago)466MITBladePHP ^8.1CI passing

Since Jan 9Pushed 1w ago1 watchersCompare

[ Source](https://github.com/awcodes/dimmer)[ Packagist](https://packagist.org/packages/awcodes/dimmer)[ Docs](https://github.com/awcodes/dimmer)[ GitHub Sponsors](https://github.com/Awcodes)[ RSS](/packages/awcodes-dimmer/feed)WikiDiscussions main Synced yesterday

READMEChangelog (3)Dependencies (8)Versions (5)Used By (0)

Dimmer
======

[](#dimmer)

[![Latest Version on Packagist](https://camo.githubusercontent.com/db68904c25256b354a09ad288333b3c3b3c84d4189abac4e97987d8b56e730cc/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6177636f6465732f64696d6d65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/awcodes/dimmer)[![Total Downloads](https://camo.githubusercontent.com/7937abaa3c01198137a66d5aea8836137edb542a01e183366bed741066abcc83/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6177636f6465732f64696d6d65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/awcodes/dimmer)

[![dimmer](https://private-user-images.githubusercontent.com/3596800/295265155-88aeda63-7ad3-448c-b6d5-526c5620747f.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MzY3OTksIm5iZiI6MTc4MjczNjQ5OSwicGF0aCI6Ii8zNTk2ODAwLzI5NTI2NTE1NS04OGFlZGE2My03YWQzLTQ0OGMtYjZkNS01MjZjNTYyMDc0N2YucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDYyOSUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjA2MjlUMTIzNDU5WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9YzZiZDYxNGVhMTljYjdmYjdhODA5MjRjN2Y5NDQ0MzMzOTEwNDUzZWNjMjY3NGRmNDBlNWIxMTAwZmVlMjMxYSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmcmVzcG9uc2UtY29udGVudC10eXBlPWltYWdlJTJGcG5nIn0.Tg9hrDZoTaadYLN6Nbv6o-TDaLvwA-D_WXcrCRTFQls)](https://private-user-images.githubusercontent.com/3596800/295265155-88aeda63-7ad3-448c-b6d5-526c5620747f.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MzY3OTksIm5iZiI6MTc4MjczNjQ5OSwicGF0aCI6Ii8zNTk2ODAwLzI5NTI2NTE1NS04OGFlZGE2My03YWQzLTQ0OGMtYjZkNS01MjZjNTYyMDc0N2YucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDYyOSUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjA2MjlUMTIzNDU5WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9YzZiZDYxNGVhMTljYjdmYjdhODA5MjRjN2Y5NDQ0MzMzOTEwNDUzZWNjMjY3NGRmNDBlNWIxMTAwZmVlMjMxYSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmcmVzcG9uc2UtY29udGVudC10eXBlPWltYWdlJTJGcG5nIn0.Tg9hrDZoTaadYLN6Nbv6o-TDaLvwA-D_WXcrCRTFQls)

Dimmer is a simple package to easily add a light/dark/system mode switcher to your Laravel app.

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

[](#requirements)

- Alpine JS
- Tailwind CSS

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

[](#installation)

You can install the package via composer:

```
composer require awcodes/dimmer
```

Next, you need to add the views to your `tailwind.config.js` file:

```
content: [
    './vendor/awcodes/dimmer/resources/views/**/*.blade.php',
]
```

Optionally (not recommended), you can publish the views using

```
php artisan vendor:publish --tag="dimmer-views"
```

You can also update the translations by publishing the lang files:

```
php artisan vendor:publish --tag="dimmer-translations"
```

Usage
-----

[](#usage)

Just include the `dimmer` component in your layout or anywhere you would to use it.

```

```

### Forcing a default mode

[](#forcing-a-default-mode)

Should you wish to force a default mode for when a user first visits the site, you can do so by setting the `force-mode` attribute on the `dimmer` component. Without this attribute set, the default mode will be determined by the user's system preferences.

```

```

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Adam Weston](https://github.com/awcodes)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance73

Regular maintenance activity

Popularity14

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~208 days

Total

3

Last Release

490d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/3596800?v=4)[Adam Weston](/maintainers/awcodes)[@awcodes](https://github.com/awcodes)

---

Top Contributors

[![awcodes](https://avatars.githubusercontent.com/u/3596800?v=4)](https://github.com/awcodes "awcodes (19 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (16 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (9 commits)")

---

Tags

bladelaravellaravel-packagelaravelawcodesdimmer

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/awcodes-dimmer/health.svg)

```
[![Health](https://phpackages.com/badges/awcodes-dimmer/health.svg)](https://phpackages.com/packages/awcodes-dimmer)
```

###  Alternatives

[spatie/laravel-pdf

Create PDFs in Laravel apps

1.0k4.8M47](/packages/spatie-laravel-pdf)[awcodes/filament-curator

A media picker plugin for FilamentPHP.

437356.9k24](/packages/awcodes-filament-curator)[spatie/laravel-blade-comments

Add debug comments to your rendered output

180335.8k](/packages/spatie-laravel-blade-comments)[statikbe/laravel-filament-flexible-content-blocks

The Laravel Filament Flexible Content Blocks package helps you to easily create content in Filament for any model, with predefined or custom blocks, and foreach block an extendable Blade view component.

17625.6k4](/packages/statikbe-laravel-filament-flexible-content-blocks)[rawilk/profile-filament-plugin

Profile &amp; MFA starter kit for filament.

3914.6k](/packages/rawilk-profile-filament-plugin)[awcodes/richer-editor

A collection of extensions and tools to enhance the Filament Rich Editor field.

3912.8k9](/packages/awcodes-richer-editor)

PHPackages © 2026

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