# upMVC > Modular PHP 8.1+ kernel. Compose SaaS and payments as Packagist libraries. Do not fork the core. upMVC (BitsHost) is an open-source MMVC-style PHP kernel: boot, router, modules, JWT middleware, migrate tool, optional islands (React/Vue). Multi-tenant SaaS is optional via Composer packs. MIT license. ## Stack - Kernel: https://github.com/upMVC/upMVC — Packagist `bitshost/upmvc` (^2.5) - Starter host: https://github.com/upMVC/upMVC-SaaS — `bitshost/upmvc-saas` (requires kernel + saas-pack; not a kernel fork) - SaaS pack: https://github.com/upMVC/upMVC-SaaS-Pack — `bitshost/upmvc-saas-pack` (^1.1) tenancy + Harvest ops - Payments pack: https://github.com/upMVC/upMVC-Payments-Pack — `bitshost/upmvc-payments-pack` (optional) - API plane (optional): https://github.com/BitsHost/PHP-CRUD-API-Generator ## Install ``` # Kernel as standalone project composer create-project bitshost/upmvc my-app # Kernel as library composer require bitshost/upmvc:^2.5 # SaaS starter composer create-project bitshost/upmvc-saas my-saas # SaaS packs into a host composer require bitshost/upmvc:^2.5 bitshost/upmvc-saas-pack:^1.1 # optional: composer require bitshost/upmvc-payments-pack ``` Register providers in host `src/Etc/packages.php` (e.g. `SaasServiceProvider`, optional `PaymentsServiceProvider`). ## Docs for agents and humans - Compose SaaS: https://github.com/upMVC/upMVC/blob/main/docs/BUILD_SAAS_APP.md - Kernel agent pack: https://github.com/upMVC/upMVC/blob/main/docs/AGENT_PACK.md - saas-next CLI: https://github.com/upMVC/upMVC-SaaS-Pack/blob/master/docs/SAAS_NEXT.md - Harvest ops: https://github.com/upMVC/upMVC-SaaS-Pack/blob/master/docs/09-harvest-ops.md - Site: https://upmvc.com/ - Archive (previous marketing): https://upmvc.com/archive/ ## Rules - Scope tenant data with `tenant_id` - Domain APIs live under `src/Modules/Api/Modules/{Domain}/` - Prefer pack libraries (Harvest, payments drivers); do not copy them into the host - Prefer Packagist pins over path-repo forks of the kernel