PHPackages                             milpa/admin - 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. milpa/admin

ActiveLibrary

milpa/admin
===========

The administration panel of the Milpa PHP framework: a discoverable section shell over the plugin, settings and routing surfaces a host exposes — server-rendered, no JavaScript required.

00PHPCI passing

Since Jul 28Pushed todayCompare

[ Source](https://github.com/getmilpa/admin)[ Packagist](https://packagist.org/packages/milpa/admin)[ RSS](/packages/milpa-admin/feed)WikiDiscussions main Synced today

READMEChangelog (1)DependenciesVersions (1)Used By (0)

 [   ![Milpa](https://raw.githubusercontent.com/getmilpa/core/main/art/lockup/milpa-lockup-v-color-light.svg)  ](https://github.com/getmilpa)

Milpa Admin
===========

[](#milpa-admin)

> The **administration panel** of the Milpa PHP framework — a section shell that discovers what your app can actually do, server-rendered, no JavaScript required.

[![CI](https://github.com/getmilpa/admin/actions/workflows/ci.yml/badge.svg)](https://github.com/getmilpa/admin/actions/workflows/ci.yml)[![Packagist](https://camo.githubusercontent.com/01e773613d349576757a06f70cb913c513acc5bec6c0dd64a4ded160a36dace1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d696c70612f61646d696e2e737667)](https://packagist.org/packages/milpa/admin)[![PHP](https://camo.githubusercontent.com/ca03f11ea27dac4dedc8ad56a7bdfc4a9ff5feb825055f9d2983616115076607/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d254532253839254135253230382e332d3737376262342e737667)](https://www.php.net/)[![License](https://camo.githubusercontent.com/798509b4df525f56802b56f8096862487f08023e3d7561c68656f8dab10d0d6e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4170616368652d2d322e302d626c75652e737667)](LICENSE)

Add one plugin to your app and `/milpa/admin` exists: a navigation, a settings form, a plugin manager, and a route inspector — behind your own auth, rendered on the server.

Install
-------

[](#install)

```
composer require milpa/admin
```

```
// config/plugins.php
return [
    Milpa\Admin\AdminPlugin::class,
    // ...
];
```

The one idea
------------

[](#the-one-idea)

**The panel knows no section by name.** It asks every booted plugin for its sections and renders what it gets back:

```
final class BillingPlugin implements PluginInterface, AdminSectionProvider
{
    public function adminSections(): array
    {
        return [new AdminSection('billing', 'Facturación', '/milpa/admin/billing', 40)];
    }
}
```

That is the whole extension point. Your section appears in the navigation, in order, with no change to this package — and the same list drives the terminal shell (`coa:admin`, `coa:tui`), so a section you add is a section you can also inspect without a browser.

What it ships with
------------------

[](#what-it-ships-with)

SectionWhat it does**Settings**The site configuration, as a form generated from the schema of a governed tool — with CSRF, validation, and redisplay of what you typed when it is rejected.**Plugins**What your app has, what boots, and a button per row. It drives `milpa/plugin`'s operations, so the panel and `coa plugins.list` cannot disagree.**Sistema**The route table, read-only.What a host has to provide
--------------------------

[](#what-a-host-has-to-provide)

Nothing is assumed and nothing is faked. A capability you did not wire simply does not appear — there are no dead controls (that is a rule, not a habit: see ADR-0005, *surface honesty*).

You registerYou get`SessionStore` + `milpa/auth`'s scope middlewareThe panel at all — every section is behind `milpa.admin`.`PluginRegistryInterface`The **Plugins** section: list, enable, disable.`PluginInstallerInterface`Install, update and remove on top of it. Without it those three operations do not exist, so no surface renders a button that fails when pressed.`RouteTableSource`The **Sistema** section. Every host builds its route table differently; this port is how yours gets in.No JavaScript required
----------------------

[](#no-javascript-required)

Every control is a real `` with a real submit. The panel enhances with JS when it is there and works identically when it is not — which matters most at the exact moment you need it: turning off the plugin that broke the page is not the time to depend on that page's JavaScript.

Two more decisions worth knowing:

- **Installing is not consenting to run.** A freshly installed plugin arrives **disabled**.
- **A plugin declared in your code cannot be removed from the panel** — it would delete files your own source still names. The panel says so, and offers to disable it instead.

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

[](#requirements)

- PHP **≥ 8.3**
- [`milpa/core`](https://packagist.org/packages/milpa/core) **^0.6** · [`milpa/auth`](https://packagist.org/packages/milpa/auth) **^0.2** · [`milpa/command`](https://packagist.org/packages/milpa/command) **^0.2** · [`milpa/data`](https://packagist.org/packages/milpa/data) **^0.2**
- [`milpa/http`](https://packagist.org/packages/milpa/http) **^0.1.5** · [`milpa/http-symfony`](https://packagist.org/packages/milpa/http-symfony) **^0.1** · [`milpa/runtime`](https://packagist.org/packages/milpa/runtime) **^0.5**
- [`milpa/plugin`](https://packagist.org/packages/milpa/plugin) **^0.3** — the operations the Plugins section drives
- [`milpa/live-web`](https://packagist.org/packages/milpa/live-web) **^0.1** · [`milpa/live-tui`](https://packagist.org/packages/milpa/live-tui) **^0.2** · [`milpa/tool-runtime`](https://packagist.org/packages/milpa/tool-runtime) **^0.6**

Contributing
------------

[](#contributing)

Contributions are welcome — see [CONTRIBUTING.md](CONTRIBUTING.md). Please report security issues via [SECURITY.md](SECURITY.md), and note that this project follows a [Code of Conduct](CODE_OF_CONDUCT.md).

License
-------

[](#license)

[Apache-2.0](LICENSE) © Rodrigo Vicente - TeamX Agency.

---

Milpa is designed, built, and maintained by **[Rodrigo Vicente - TeamX Agency](https://teamx.agency/?utm_source=github&utm_medium=readme&utm_campaign=milpa&utm_content=admin)**.

###  Health Score

21

—

LowBetter than 17% of packages

Maintenance65

Regular maintenance activity

Popularity0

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

 Bus Factor1

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

### Community

Maintainers

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

---

Top Contributors

[![rodrigoteamx](https://avatars.githubusercontent.com/u/269849276?v=4)](https://github.com/rodrigoteamx "rodrigoteamx (4 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (1 commits)")

### Embed Badge

![Health badge](/badges/milpa-admin/health.svg)

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

PHPackages © 2026

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