PHPackages                             invoiceshelf/modules - 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 &amp; Helpers](/categories/utility)
4. /
5. invoiceshelf/modules

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

invoiceshelf/modules
====================

InvoiceShelf-specific extensions for nwidart/laravel-modules — registry for module-contributed sidebar items and settings schemas.

3.0.2(2mo ago)022.4k↓36.6%MITPHPPHP ^8.3

Since Dec 21Pushed 1mo agoCompare

[ Source](https://github.com/InvoiceShelf/modules)[ Packagist](https://packagist.org/packages/invoiceshelf/modules)[ RSS](/packages/invoiceshelf-modules/feed)WikiDiscussions master Synced 3d ago

READMEChangelogDependencies (11)Versions (5)Used By (0)

InvoiceShelf Modules
====================

[](#invoiceshelf-modules)

A thin extension package on top of [`nwidart/laravel-modules`](https://github.com/nWidart/laravel-modules) that adds an InvoiceShelf-specific registry for module-contributed sidebar entries and settings schemas.

What it provides
----------------

[](#what-it-provides)

- **`InvoiceShelf\Modules\Registry`** — a static registry that modules call from their `ServiceProvider::boot()` to declare:
    - A sidebar entry (title, link, icon) that the host app renders in the company sidebar's "Modules" group.
    - A settings schema (sections of typed fields) that the host app renders generically as a form via `BaseSchemaForm.vue`, with values stored per-company.
- **`InvoiceShelf\Modules\Settings\Schema` / `FieldType`** — a value object + enum that lock down the supported field types (`text`, `password`, `textarea`, `switch`, `number`, `select`, `multiselect`) and validate the schema shape at registration time.

The actual module loading, file generation, migration, and provider registration are all handled by upstream `nwidart/laravel-modules` (required as a composer dependency).

Usage from inside a module
--------------------------

[](#usage-from-inside-a-module)

```
use InvoiceShelf\Modules\Registry;

class SalesTaxUsServiceProvider extends ServiceProvider
{
    public function boot(): void
    {
        Registry::registerMenu('sales-tax-us', [
            'title' => 'sales_tax_us::menu.title',
            'link'  => '/admin/modules/sales-tax-us/settings',
            'icon'  => 'CalculatorIcon',
        ]);

        Registry::registerSettings('sales-tax-us', [
            'sections' => [
                [
                    'title'  => 'sales_tax_us::settings.connection',
                    'fields' => [
                        ['key' => 'api_key', 'type' => 'password', 'rules' => ['required']],
                        ['key' => 'sandbox', 'type' => 'switch',   'default' => false],
                    ],
                ],
            ],
        ]);
    }
}
```

Because `nwidart/laravel-modules` only boots providers for currently-activated modules, the registry naturally only contains active modules at request time — no extra filtering needed.

License
-------

[](#license)

MIT. See [LICENSE.md](LICENSE.md).

###  Health Score

54

—

FairBetter than 96% of packages

Maintenance89

Actively maintained with recent releases

Popularity27

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity68

Established project with proven stability

 Bus Factor1

Top contributor holds 77.3% 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 ~524 days

Total

4

Last Release

84d ago

Major Versions

1.0.0 → 3.0.02026-04-08

PHP version history (2 changes)1.0.0PHP &gt;=7.3

3.0.0PHP ^8.3

### Community

Maintainers

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

---

Top Contributors

[![nWidart](https://avatars.githubusercontent.com/u/882397?v=4)](https://github.com/nWidart "nWidart (689 commits)")[![Kyslik](https://avatars.githubusercontent.com/u/2067589?v=4)](https://github.com/Kyslik "Kyslik (34 commits)")[![lindo-llc](https://avatars.githubusercontent.com/u/11467641?v=4)](https://github.com/lindo-llc "lindo-llc (17 commits)")[![ahmedggalal](https://avatars.githubusercontent.com/u/38420331?v=4)](https://github.com/ahmedggalal "ahmedggalal (16 commits)")[![rcbgalido](https://avatars.githubusercontent.com/u/10085573?v=4)](https://github.com/rcbgalido "rcbgalido (13 commits)")[![mikemand](https://avatars.githubusercontent.com/u/745184?v=4)](https://github.com/mikemand "mikemand (11 commits)")[![Schweppesale](https://avatars.githubusercontent.com/u/175759?v=4)](https://github.com/Schweppesale "Schweppesale (10 commits)")[![pickmanmurimi](https://avatars.githubusercontent.com/u/15788867?v=4)](https://github.com/pickmanmurimi "pickmanmurimi (9 commits)")[![gdarko](https://avatars.githubusercontent.com/u/5760249?v=4)](https://github.com/gdarko "gdarko (9 commits)")[![KABBOUCHI](https://avatars.githubusercontent.com/u/9212274?v=4)](https://github.com/KABBOUCHI "KABBOUCHI (8 commits)")[![mohitpanjwani](https://avatars.githubusercontent.com/u/8002555?v=4)](https://github.com/mohitpanjwani "mohitpanjwani (6 commits)")[![jnbn](https://avatars.githubusercontent.com/u/112425?v=4)](https://github.com/jnbn "jnbn (6 commits)")[![rjvandoesburg](https://avatars.githubusercontent.com/u/1488300?v=4)](https://github.com/rjvandoesburg "rjvandoesburg (5 commits)")[![debuqer](https://avatars.githubusercontent.com/u/24442370?v=4)](https://github.com/debuqer "debuqer (4 commits)")[![FaZeRs](https://avatars.githubusercontent.com/u/9529341?v=4)](https://github.com/FaZeRs "FaZeRs (4 commits)")[![balping](https://avatars.githubusercontent.com/u/5840038?v=4)](https://github.com/balping "balping (4 commits)")[![nmfzone](https://avatars.githubusercontent.com/u/10361906?v=4)](https://github.com/nmfzone "nmfzone (4 commits)")[![ReinierH](https://avatars.githubusercontent.com/u/8132589?v=4)](https://github.com/ReinierH "ReinierH (4 commits)")[![Rezrazi](https://avatars.githubusercontent.com/u/2086576?v=4)](https://github.com/Rezrazi "Rezrazi (4 commits)")[![RSpeekenbrink](https://avatars.githubusercontent.com/u/7093216?v=4)](https://github.com/RSpeekenbrink "RSpeekenbrink (4 commits)")

---

Tags

laravelmodulesinvoiceshelf

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/invoiceshelf-modules/health.svg)

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

PHPackages © 2026

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