PHPackages                             bakerkretzmar/nova-settings-tool - 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. bakerkretzmar/nova-settings-tool

ActiveLibrary

bakerkretzmar/nova-settings-tool
================================

A Laravel Nova tool to manage application settings.

2.1.0(1y ago)164212.2k↑13.3%34[1 issues](https://github.com/bakerkretzmar/nova-settings-tool/issues)MITPHPPHP ^8.1

Since Jan 14Pushed 1y ago2 watchersCompare

[ Source](https://github.com/bakerkretzmar/nova-settings-tool)[ Packagist](https://packagist.org/packages/bakerkretzmar/nova-settings-tool)[ Docs](https://github.com/bakerkretzmar/nova-settings-tool)[ RSS](/packages/bakerkretzmar-nova-settings-tool/feed)WikiDiscussions 2.x Synced 1mo ago

READMEChangelog (10)Dependencies (5)Versions (26)Used By (0)

Laravel Nova tool to manage app settings
========================================

[](#laravel-nova-tool-to-manage-app-settings)

[![Latest Version on Packagist](https://camo.githubusercontent.com/83ed6b662284412cc6ee5210970dc03f0ec96a5742be7c4a554e6d5fbc4e8468/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f62616b65726b7265747a6d61722f6e6f76612d73657474696e67732d746f6f6c2e7376673f7374796c653d666c6174)](https://packagist.org/packages/bakerkretzmar/nova-settings-tool)[![Total Downloads](https://camo.githubusercontent.com/179570e362f889df4922348ecd523953ff8308e4df2a1f0ae7c3a5cc7840e804/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f62616b65726b7265747a6d61722f6e6f76612d73657474696e67732d746f6f6c2e7376673f7374796c653d666c6174)](https://packagist.org/packages/bakerkretzmar/nova-settings-tool)[![Build](https://github.com/bakerkretzmar/nova-settings-tool/workflows/CI/badge.svg)](https://github.com/bakerkretzmar/nova-settings-tool/actions)[![License: MIT](https://camo.githubusercontent.com/59497bc4563dd468e37bbf539439e60cacf196f537f678b721a8efabf21c64ef/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d626c75652e7376673f7374796c653d666c6174)](https://opensource.org/licenses/MIT)

Store and edit simple app-wide settings right in Nova. Settings are stored as JSON using [`spatie/valuestore`](https://github.com/spatie/valuestore), making them really easy to [pull in and use everywhere else in your app](https://laravel-news.com/global-application-settings).

[![Settings Tool screenshot](settings-tool.png)](settings-tool.png)

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

[](#installation)

Install the package via Composer in any Laravel app using [Nova](https://nova.laravel.com):

```
composer require bakerkretzmar/nova-settings-tool
```

> Nova Settings Tool v2 requires Nova 4—for older versions of Nova, use v1 of this package.

Publish the default configuration file to `config/nova-settings-tool.php`:

```
php artisan vendor:publish --tag="nova-settings-tool"
```

Register the tool with Nova in the `tools` method of your `NovaServiceProvider`:

```
// in app/Providers/NovaServiceProvider.php

use Bakerkretzmar\NovaSettingsTool\SettingsTool;

    // ...

    public function tools()
    {
        return [
            new SettingsTool,
        ];
    }
```

Usage
-----

[](#usage)

Settings are declared in a `nova-settings-tool.php` config file. This file specifies where settings are stored, what the tool’s title is in Nova’s sidebar, the layout of the settings page, and metadata about the settings themselves.

A [default config file with some helpful examples](config/nova-settings-tool.php) is included as a starting point:

Each item in the `settings` array is rendered as an input with a label and help text, similar to one of Nova’s fields. Settings can also be grouped into panels, to separate them visually.

The settings’ actual values are stored as JSON at the location specified in the config file—`storage/app/settings.json` by default.

There are currently six available setting types:

- `text`: Single-line text input
- `textarea`: Multi-line text input
- `toggle`: Boolean switch
- `code`: [CodeMirror](https://codemirror.net/) text editor
- `number`: Number input
- `select`: Single-select dropdown

All strings in this package, and any you pass to it, can easily be translated using [Laravel’s built-in localization features](https://laravel.com/docs/localization#using-translation-strings-as-keys).

This tool also fires an event any time any settings are changed, with all the old and new settings attached.

Roadmap
-------

[](#roadmap)

The following features are planned or in development:

- `color` setting type
- `date` setting type
- `file` setting type
- setting validation

---

[CHANGELOG](CHANGELOG.md) • [CONTRIBUTING](CONTRIBUTING.md) • [LICENSE](LICENSE.md)

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance41

Moderate activity, may be stable

Popularity51

Moderate usage in the ecosystem

Community21

Small or concentrated contributor base

Maturity79

Established project with proven stability

 Bus Factor1

Top contributor holds 87.9% 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 ~87 days

Recently: every ~156 days

Total

26

Last Release

490d ago

Major Versions

0.3.3 → 1.02019-09-29

1.x-dev → 2.0.02022-04-17

PHP version history (4 changes)0.1PHP &gt;=7.1.0

1.1.1PHP ^7.1|^8.0

2.0.0PHP ^7.3|^8.0

2.1.0PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/49a7ea27b2815fb208a46e27bf867eb802bc951bb257ee5fa1097eaaf651d34e?d=identicon)[bakerkretzmar](/maintainers/bakerkretzmar)

---

Top Contributors

[![bakerkretzmar](https://avatars.githubusercontent.com/u/18192441?v=4)](https://github.com/bakerkretzmar "bakerkretzmar (80 commits)")[![crynobone](https://avatars.githubusercontent.com/u/172966?v=4)](https://github.com/crynobone "crynobone (3 commits)")[![FabioWidmer](https://avatars.githubusercontent.com/u/6362414?v=4)](https://github.com/FabioWidmer "FabioWidmer (2 commits)")[![cyruscollier](https://avatars.githubusercontent.com/u/6005043?v=4)](https://github.com/cyruscollier "cyruscollier (1 commits)")[![bomshteyn](https://avatars.githubusercontent.com/u/4259699?v=4)](https://github.com/bomshteyn "bomshteyn (1 commits)")[![itinnovative](https://avatars.githubusercontent.com/u/6822319?v=4)](https://github.com/itinnovative "itinnovative (1 commits)")[![jonassiewertsen](https://avatars.githubusercontent.com/u/38906163?v=4)](https://github.com/jonassiewertsen "jonassiewertsen (1 commits)")[![MarceauKa](https://avatars.githubusercontent.com/u/1665333?v=4)](https://github.com/MarceauKa "MarceauKa (1 commits)")[![ramonrietdijk](https://avatars.githubusercontent.com/u/85165272?v=4)](https://github.com/ramonrietdijk "ramonrietdijk (1 commits)")

---

Tags

laravellaravel-novanovaphpsettingsvuelaravelSettingstoolnova

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/bakerkretzmar-nova-settings-tool/health.svg)

```
[![Health](https://phpackages.com/badges/bakerkretzmar-nova-settings-tool/health.svg)](https://phpackages.com/packages/bakerkretzmar-nova-settings-tool)
```

###  Alternatives

[outl1ne/nova-settings

A Laravel Nova tool for editing custom settings using native Nova fields.

296883.2k3](/packages/outl1ne-nova-settings)[optimistdigital/nova-settings

A Laravel Nova tool for editing custom settings using native Nova fields.

297874.5k3](/packages/optimistdigital-nova-settings)[oneduo/nova-file-manager

A handy file manager tool for Laravel Nova

157350.3k2](/packages/oneduo-nova-file-manager)[runlinenl/nova-profile-tool

A tool for Laravel Nova to allow users to edit their profile data

37217.5k](/packages/runlinenl-nova-profile-tool)[bbs-lab/nova-file-manager

A handy file manager tool for Laravel Nova

1578.0k](/packages/bbs-lab-nova-file-manager)[stepanenko3/nova-settings

This Laravel Nova settings tool based on env, using nativ nova fields and resources

3219.8k](/packages/stepanenko3-nova-settings)

PHPackages © 2026

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