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.15.0(2mo ago)675.2k—5.8%2[1 issues](https://github.com/artkonekt/gears/issues)2MITPHPPHP ^8.3CI failing

Since May 27Pushed 2mo ago3 watchersCompare

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

READMEChangelogDependencies (12)Versions (33)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

61

—

FairBetter than 98% of packages

Maintenance81

Actively maintained with recent releases

Popularity36

Limited adoption so far

Community20

Small or concentrated contributor base

Maturity89

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 98.2% 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 ~93 days

Recently: every ~213 days

Total

32

Last Release

78d ago

Major Versions

0.9.2 → 1.0.0-rc.12018-06-09

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

1.2.0PHP ^7.1.3

1.3.0PHP ^7.2

1.7.0PHP ^7.3|^8.0

1.9.0PHP ^8.0

1.14.0PHP ^8.1

1.x-devPHP ^8.3

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/5520702?v=4)[konekt](/maintainers/konekt)[@konekt](https://github.com/konekt)

---

Top Contributors

[![fulopattila122](https://avatars.githubusercontent.com/u/1162360?v=4)](https://github.com/fulopattila122 "fulopattila122 (108 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

[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M346](/packages/psalm-plugin-laravel)[yajra/laravel-oci8

Oracle DB driver for Laravel via OCI8

8793.2M25](/packages/yajra-laravel-oci8)[api-platform/laravel

API Platform support for Laravel

58171.6k14](/packages/api-platform-laravel)[wearepixel/laravel-cart

A cart implementation for Laravel

1374.8k](/packages/wearepixel-laravel-cart)

PHPackages © 2026

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