PHPackages                             superpms/extend-kits - 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. superpms/extend-kits

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

superpms/extend-kits
====================

pms kits extend

v1.0.x-dev(yesterday)034Apache-2.0PHPPHP >=8.1

Since Jul 4Pushed 3w agoCompare

[ Source](https://github.com/superpms/extend-kits)[ Packagist](https://packagist.org/packages/superpms/extend-kits)[ RSS](/packages/superpms-extend-kits/feed)WikiDiscussions v1.0 Synced today

READMEChangelogDependencies (1)Versions (1)Used By (0)

superpms/extend-kits
====================

[](#superpmsextend-kits)

`superpms/extend-kits` is the SuperPMS composer package that makes project-local kits discoverable at runtime. It mounts the project kits directory, reads kit manifests, loads per-kit bootstrap files, exposes kit metadata and state helpers, and provides small base utilities for kit code.

This package is framework infrastructure. It does not implement a business kit by itself; business kits live under the host project's `kits` directory, for example `server/kits//`.

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

[](#requirements)

- PHP `8.1+`
- Composer PSR-4 autoload for namespace `pms\`
- SuperPMS lifecycle hooks from `superpms/basic`

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

[](#installation)

```
composer require superpms/extend-kits
```

The package declares `extra.pms` in `composer.json`. In a SuperPMS project, the vendor install hook uses that metadata to create `/kits` and copy the default `kit.json` template from `resource/kit.json`.

What This Package Provides
--------------------------

[](#what-this-package-provides)

- Boot lifecycle integration through `bin/autoload.php` and `pms\extend\kits\Setup`.
- `kitsRoot` path mounting based on `BootOptions::get_extend('kits', '/kits')`.
- Root `kit.json` loading and per-kit `define.php` / `autoload.php` inclusion.
- Manifest helpers through `pms\helper\kits\KitsRegistryCenter`.
- Typed access to `kit.json`, `kit.extra.json`, manage/customer config files, and service declarations through `pms\program\kits\KitFileSource`.
- The `pms\app\KitsApp` trait for kit classes that need to resolve their own kit path and `config.php`.

Documentation
-------------

[](#documentation)

Start with [docs/00-index.md](docs/00-index.md).

The docs are organized by domain, module, how-to guide, internal mechanism, and reference material. They are based on the current package code plus server-side usage points under `server/app`, `server/core`, and `server/kits`.

Important Boundaries
--------------------

[](#important-boundaries)

- The package defines the kit loading and manifest access layer; it does not own platform or tenant HTTP policy.
- Kit install state is stored in each kit's `kit.extra.json`, while tenant activation is stored by server-side code.
- `services` declarations are generic provider metadata. Actual provider dispatch is handled by server adapters and connectors.
- `manage.install` is parsed by `KitFileSource::getManageInstall()`, but current server install endpoints do not execute those actions.

Development
-----------

[](#development)

Keep package changes inside this package and validate Markdown after documentation updates. At minimum, check that the files are UTF-8 text and that relative links resolve from the document that declares them.

When code changes are made, run the relevant PHP syntax or test checks for the changed files.

License
-------

[](#license)

SuperPMS is released under the Apache-2.0 license. See [LICENSE.txt](LICENSE.txt).

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance97

Actively maintained with recent releases

Popularity9

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity26

Early-stage or recently created project

 Bus Factor1

Top contributor holds 66.7% 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

Unknown

Total

1

Last Release

1d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/be4f8ca688945fc17bb53deca1a956f72abfef2bd156e542bf899b0d2b15c08d?d=identicon)[xiyiao](/maintainers/xiyiao)

---

Top Contributors

[![XiyiaoBoss](https://avatars.githubusercontent.com/u/170755009?v=4)](https://github.com/XiyiaoBoss "XiyiaoBoss (14 commits)")[![kid-caaccf](https://avatars.githubusercontent.com/u/34892782?v=4)](https://github.com/kid-caaccf "kid-caaccf (7 commits)")

### Embed Badge

![Health badge](/badges/superpms-extend-kits/health.svg)

```
[![Health](https://phpackages.com/badges/superpms-extend-kits/health.svg)](https://phpackages.com/packages/superpms-extend-kits)
```

###  Alternatives

[moderntribe/tribe-libs

A library for use on Modern Tribe service projects.

1349.8k2](/packages/moderntribe-tribe-libs)

PHPackages © 2026

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