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 at Api/Modules/{Domain}
  • SaaS data scoped with tenant_id
  • AI agents: php src/Tools/upmvc-next.php in the kernel; saas-next on composed hosts