PHPackages                             konekt/gears - 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. konekt/gears

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

konekt/gears
============

Settings and User Preferences library for Laravel

1.14.0(1y ago)671.9k↓34.6%2[1 issues](https://github.com/artkonekt/gears/issues)2MITPHPPHP ^8.1CI passing

Since May 27Pushed 1y ago3 watchersCompare

[ Source](https://github.com/artkonekt/gears)[ Packagist](https://packagist.org/packages/konekt/gears)[ RSS](/packages/konekt-gears/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (6)Versions (32)Used By (2)

Settings & Preferences In Laravel Applications
==================================================

[](#settings--preferences-in-laravel-applications)

[![Tests](https://camo.githubusercontent.com/0a51e150972906451baa679c6ab6c2e0b947ab6a9dd2b7c7f1802938ad14e9f5/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6172746b6f6e656b742f67656172732f74657374732e796d6c3f6272616e63683d6d6173746572267374796c653d666c61742d737175617265)](https://github.com/artkonekt/gears/actions?query=workflow%3Atests)[![Packagist Stable Version](https://camo.githubusercontent.com/28f06054c1d638c7756969205427d5cb6787d80e9428cd1c3d883ed0fedc5864/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6b6f6e656b742f67656172732e7376673f7374796c653d666c61742d737175617265266c6162656c3d737461626c65)](https://packagist.org/packages/konekt/gears)[![StyleCI](https://camo.githubusercontent.com/b45b5b36d7650c686d6c56b8a03a83404163606a2cd57c9f427d893373d31161/68747470733a2f2f7374796c6563692e696f2f7265706f732f3132353636373333342f736869656c643f6272616e63683d6d6173746572)](https://styleci.io/repos/125667334)[![Packagist downloads](https://camo.githubusercontent.com/0b3fe7d5547dce0dcbc6c6854b7436e0c9a1d8542dec995cb1c0a15f5bdba764/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6b6f6e656b742f67656172732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/konekt/gears)[![MIT Software License](https://camo.githubusercontent.com/942e017bf0672002dd32a857c95d66f28c5900ab541838c6c664442516309c8a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e7376673f7374796c653d666c61742d737175617265)](LICENSE)

This Laravel package allows you to manage and save/retrieve settings and preferences in your Laravel application.

- **Settings** are user defined values that **apply to the application**.
- **Preferences** are user defined values that **apply to a specific user**.

Settings and preferences are being managed separately. Values (by default) are being saved to the database (`settings` and `preferences` tables) and are cached with the [configured cache](https://laravel.com/docs/8.x/cache) for your application.

The backend for storing the settings can be completely replaced, so it is possible to store them in anywhere else like MongoDB, ElasticSearch, Firebase, DynamoDB, S3, etc.

Laravel Compatibility
---------------------

[](#laravel-compatibility)

LaravelGears5.40.9 - 1.15.50.9 - 1.25.60.9 - 1.25.71.1 - 1.25.81.2 - 1.56.x1.2 - 1.87.x1.3 - 1.88.x1.5 - 1.109.x1.8 - 1.1210.x1.11+11.x1.13+12.x1.14+Installation
------------

[](#installation)

> Minimum requirements (as of v1.13) are PHP 8.1 and Laravel 10.0

Install with composer:

```
composer require konekt/gears
```

The service provider and the aliases (facades) get registered automatically.

Usage
-----

[](#usage)

Settings are identified by a key (string) and need to be registered in order to be used.

#### Register Settings

[](#register-settings)

```
/** @var \Konekt\Gears\Registry\SettingsRegistry $settingsRegistry */
$settingsRegistry = app('gears.settings_registry');

$settingsRegistry->addByKey('mailchimp.api_key');
```

#### Saving And Retrieving Settings

[](#saving-and-retrieving-settings)

```
use Konekt\Gears\Facades\Settings;

// using the facade:
Settings::set('mailchimp.api_key', '123456789abcdef');
echo Settings::get('mailchimp.api_key');
// '123456789abcdef'

// using the service from the container:
$settings = app('gears.settings');
$settings->set('mailchimp.api_key', 'fbcdef');
echo $settings->get('mailgun.api_key');
// fbcdef
```

To run the entire CI job suite locally: `act -P ubuntu-latest=shivammathur/node:latest`

There are many more options and possibilities detailed in the [Documentation](https://konekt.dev/gears).

###  Health Score

49

—

FairBetter than 95% of packages

Maintenance41

Moderate activity, may be stable

Popularity36

Limited adoption so far

Community18

Small or concentrated contributor base

Maturity83

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 98.1% 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 ~82 days

Recently: every ~148 days

Total

31

Last Release

441d ago

Major Versions

0.9.2 → 1.0.0-rc.12018-06-09

PHP version history (6 changes)0.9.0PHP >=7.0.0

1.2.0PHP ^7.1.3

1.3.x-devPHP ^7.2

1.7.0PHP ^7.3|^8.0

1.9.0PHP ^8.0

1.x-devPHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/9c398dd02c93ecf6aa344f367f5744aeb32b4c7bbc23b1b22e95336f45bf0d5a?d=identicon)[konekt](/maintainers/konekt)

---

Top Contributors

[![fulopattila122](https://avatars.githubusercontent.com/u/1162360?v=4)](https://github.com/fulopattila122 "fulopattila122 (106 commits)")[![SDLyu](https://avatars.githubusercontent.com/u/2996108?v=4)](https://github.com/SDLyu "SDLyu (1 commits)")[![StyleCIBot](https://avatars.githubusercontent.com/u/11048387?v=4)](https://github.com/StyleCIBot "StyleCIBot (1 commits)")

---

Tags

laravelSettingspreferenceskonektartkonekt

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/konekt-gears/health.svg)

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

###  Alternatives

[barryvdh/laravel-ide-helper

Laravel IDE Helper, generates correct PHPDocs for all Facade classes, to improve auto-completion.

14.9k123.0M687](/packages/barryvdh-laravel-ide-helper)[edvinaskrucas/settings

Persistent settings package for Laravel framework.

22483.1k1](/packages/edvinaskrucas-settings)[glhd/special

1929.4k](/packages/glhd-special)[bjuppa/laravel-blog

Add blog functionality to your Laravel project

483.3k2](/packages/bjuppa-laravel-blog)

PHPackages © 2026

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