BitsHost · PHP 8.1+
upMVC
A modular PHP kernel. Build thin hosts. Add SaaS and payments as libraries — you do not fork the core.
composer require bitshost/upmvc
The stack
Optional layers. Nothing is mandatory until you need it.
bitshost/upmvc → kernel
bitshost/upmvc-saas-pack → tenancy + Harvest ops
bitshost/upmvc-payments-pack → optional payments
your host app → domain modules only
Pieces
Each repo has one job. Open the one you need.
-
upMVC
Kernel: boot, router, modules, JWT middleware, migrate tool, agent pack. Packagist
bitshost/upmvc(^2.5). -
upMVC-SaaS
Thin composed starter host —
public/,.env,packages.php. Requires the kernel and saas-pack. Not a copy of the kernel. -
upMVC-SaaS-Pack
Installable SaaS floor: tenants, plans, JWT auth APIs, platform admin, Harvest (mail, notify, audit, MFA). Packagist
bitshost/upmvc-saas-pack(^1.1). -
upMVC-Payments-Pack
Optional payments: gateway contracts, tenant-scoped intents (cash / bank / Stripe / …). Separate from saas-pack. Packagist
bitshost/upmvc-payments-pack. -
PHP CRUD API Generator
Optional API plane: REST over MySQL/MariaDB, auth, OpenAPI. Compose with the kernel when you want a full data API.
Install
Kernel alone, or compose SaaS on top. Same package either way.
Kernel — standalone project
Full app tree: public/, src/Etc/, Welcome module. Demos are optional (Releases zip).
composer create-project bitshost/upmvc my-app
cd my-app
# configure src/Etc/.env
php -S localhost:8000 -t public
Kernel — as a library
Inside an existing Composer app. Boot via the kernel; your app owns the entry point.
composer require bitshost/upmvc:^2.5
SaaS — starter host
Thin composed app that already requires kernel + saas-pack.
composer create-project bitshost/upmvc-saas my-saas
cd my-saas
php scripts/setup.php
php vendor/bitshost/upmvc/src/Tools/migrate.php
php vendor/bitshost/upmvc-saas-pack/bin/saas-next.php doctor
SaaS — packs into your host
Same as library mode, plus tenancy / optional payments.
composer require bitshost/upmvc:^2.5 bitshost/upmvc-saas-pack:^1.1
# optional:
# composer require bitshost/upmvc-payments-pack
// src/Etc/packages.php
return [
\BitsHost\UpmvcSaas\SaasServiceProvider::class,
// \BitsHost\UpmvcPayments\PaymentsServiceProvider::class,
];
SaaS walkthrough: BUILD_SAAS_APP.md · Host helper: saas-next · Kernel docs: upMVC README
Facts
- PHP 8.1+, PSR-4, MIT
- Modules under
src/Modules— domain APIs atApi/Modules/{Domain} - SaaS data scoped with
tenant_id - AI agents:
php src/Tools/upmvc-next.phpin the kernel;saas-nexton composed hosts