PHPackages                             univeros/framework - 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. [Framework](/categories/framework)
4. /
5. univeros/framework

ActiveLibrary[Framework](/categories/framework)

univeros/framework
==================

The Univeros Framework.

v2.5.1(1mo ago)22100[6 issues](https://github.com/univeros/framework/issues)1MITPHPPHP &gt;=8.3CI passing

Since May 30Pushed 1mo ago2 watchersCompare

[ Source](https://github.com/univeros/framework)[ Packagist](https://packagist.org/packages/univeros/framework)[ Docs](https://univeros.io)[ RSS](/packages/univeros-framework/feed)WikiDiscussions master Synced 1w ago

READMEChangelogDependencies (96)Versions (14)Used By (1)

Univeros Framework
==================

[](#univeros-framework)

 *The source code of the Univeros framework. Namespace: `Altair\*`. Ships as `composer require univeros/framework`.*

 [![CI](https://github.com/univeros/framework/actions/workflows/ci.yml/badge.svg)](https://github.com/univeros/framework/actions/workflows/ci.yml) [![License: MIT](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://opensource.org/licenses/MIT) [![PHP 8.3+](https://camo.githubusercontent.com/4519ee1b2a64f735b1d4da1d494c2062b177768ba3524d550379f73d9fc2f997/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344382e332d3737374242342e737667)](https://camo.githubusercontent.com/4519ee1b2a64f735b1d4da1d494c2062b177768ba3524d550379f73d9fc2f997/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344382e332d3737374242342e737667) [![36 packages](https://camo.githubusercontent.com/a702a2cfcd44e05c504c177f61d3ddbcf3f1ba46bb67ee055588673c6a5c1315/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7061636b616765732d33362d737563636573732e737667)](https://camo.githubusercontent.com/a702a2cfcd44e05c504c177f61d3ddbcf3f1ba46bb67ee055588673c6a5c1315/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7061636b616765732d33362d737563636573732e737667)

---

> **Note:** this repository contains the core code of Univeros. If you want to build an application using Univeros, visit the main [**univeros/univeros**](https://github.com/univeros/univeros) repository.

About Univeros
--------------

[](#about-univeros)

Univeros is a PHP 8.3+ framework for building APIs. Its codebase lives under the `Altair\*` namespace, the engineering name, the way `Illuminate\*` is the engineering name for Laravel's components. The brand consumers see is **Univeros**; `Altair\*` is the plumbing.

It looks familiar at first: PSR-7/15 HTTP stack, a DI container, a Cycle ORM bridge, a Symfony Messenger bridge, immutable value objects, single-pass middleware. The unusual part is the layer above that: a CLI surface (`bin/altair`) whose every command emits deterministic JSON an AI agent can branch on, and a set of primitives (**spec-driven scaffolding, a rewindable journal, an append-only event log, a symbol-usage index, a doctor, a refactor adviser, an MCP server**) designed so an agent can be productive without a human in the loop.

For the pitch, agent affordances walkthrough, and architecture diagram, see [**univeros/univeros**](https://github.com/univeros/univeros). For per-package guides, see [**univeros/docs**](https://github.com/univeros/docs).

Sub-packages
------------

[](#sub-packages)

The framework is composed of 36 standalone PHP packages under [src/Altair/](src/Altair/). Each is published as a read-only repository at `github.com/univeros/`. Pull the whole framework via:

```
composer require univeros/framework
```

…or compose individual packages:

```
composer require univeros/http          # PSR-7 + PSR-15 stack, single-pass middleware
composer require univeros/scaffold      # YAML spec → Action/Input/Responder + OpenAPI + tests
composer require univeros/persistence   # Repository/UnitOfWork bridge over Cycle ORM v2
composer require univeros/messaging     # MessageBus bridge over Symfony Messenger
composer require univeros/events        # Append-only mutation event log for agents
```

The complete published list: `agent-spec`, `bootstrap`, `cache`, `cli`, `common`, `configuration`, `container`, `cookie`, `courier`, `data`, `doctor`, `eval`, `events`, `examples`, `filesystem`, `happen`, `http`, `index`, `introspection`, `mcp`, `messaging`, `middleware`, `migration-intelligence`, `observability`, `observatory`, `persistence`, `profiling`, `sanitation`, `scaffold`, `security`, `session`, `structure`, `suggest`, `test-reporter`, `tinker`, `validation`.

Splits are produced automatically by [.github/workflows/split.yml](.github/workflows/split.yml); see [docs/guides/split-publish.md](docs/guides/split-publish.md) for the operator runbook. All changes belong in this monorepo; the split repos are read-only mirrors.

Repositories
------------

[](#repositories)

- **[univeros/univeros](https://github.com/univeros/univeros)**: `composer create-project` starter and the main entry point for application developers.
- **[univeros/framework](https://github.com/univeros/framework)**: this repo. The library source.
- **[univeros/docs](https://github.com/univeros/docs)**: per-package documentation.

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

[](#contributing)

Issues and pull requests are welcome on this repository; it's the source of truth. The 35 sub-package repos under `github.com/univeros/*` are read-only mirrors; PRs against them will be ignored and overwritten on the next split.

Before submitting:

```
composer qa     # cs + stan + test — the pre-commit gate
composer test   # PHPUnit 12 only
```

CI mirrors the same gates plus the determinism drift check. Add a bullet to the [`CHANGELOG.md`](CHANGELOG.md) `[Unreleased]` section for any user-facing change.

Security
--------

[](#security)

If you discover a security vulnerability, please **report it privately via [GitHub Security Advisories](https://github.com/univeros/framework/security/advisories/new)** instead of opening a public issue. We will respond and coordinate disclosure from there.

License
-------

[](#license)

Univeros is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).

###  Health Score

47

—

FairBetter than 93% of packages

Maintenance85

Actively maintained with recent releases

Popularity22

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 98.8% 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 ~1 days

Total

10

Last Release

48d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/566016?v=4)[Antonio Ramirez](/maintainers/tonydspaniard)[@tonydspaniard](https://github.com/tonydspaniard)

---

Top Contributors

[![tonydspaniard](https://avatars.githubusercontent.com/u/566016?v=4)](https://github.com/tonydspaniard "tonydspaniard (161 commits)")[![resurtm](https://avatars.githubusercontent.com/u/100198?v=4)](https://github.com/resurtm "resurtm (2 commits)")

---

Tags

frameworkmicrophpuniverosframeworkuniveros

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/univeros-framework/health.svg)

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

###  Alternatives

[tempest/framework

The PHP framework that gets out of your way.

2.2k34.4k16](/packages/tempest-framework)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.6M600](/packages/shopware-core)[laravel/framework

The Laravel Framework.

34.8k543.8M20.5k](/packages/laravel-framework)[shopware/platform

The Shopware e-commerce core

3.4k1.5M3](/packages/shopware-platform)[typo3/cms

TYPO3 CMS is a free open source Content Management Framework initially created by Kasper Skaarhoj and licensed under GNU/GPL.

1.2k1.9M122](/packages/typo3-cms)[flow-php/flow

PHP ETL - Extract Transform Load - Data processing framework

85036.3k](/packages/flow-php-flow)

PHPackages © 2026

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