bhooai-nexus 2.0.9 → 2.0.11

package/README.md

@@ -192,6 +192,56 @@ seeder · migration · provider · plugin
 | `file-storage` | local + S3 storage, signed private URLs |
 | `multi-app` | two backends, two frontends, one admin |
 
+### Multi-app example — how to use
+
+Nexus as a platform: two backends (`shop` + `api`) and two frontends (`web` + `shop`) in one project, single admin. The overlay ships only two route files; actual `apps/` are scaffolded via `nexus add`.
+
+**Option A — fresh project (wizard):**
+
+```bash
+npx nexus init my-platform
+# wizard: Starter -> Examples -> pick "multi-app" -> Admin? Yes -> Features/Ports/Infra -> Review & create
+cd my-platform
+
+# scaffold the extra backends (ports auto-assigned in .nexus-ports.json)
+npx nexus add backend shop
+npx nexus add backend api
+
+# wire frontends to chosen backends (--for sets Vite proxy /api, /uploads, /ws)
+npx nexus add frontend shop --for backend-shop
+npx nexus add frontend web --for backend
+
+npx nexus dev
+```
+
+Or non-interactively: `npx nexus init my-platform --example multi-app` then run the same `add` commands.
+
+**Option B — existing project:**
+
+```bash
+npx nexus add backend shop
+npx nexus add backend api
+# if project wasn't inited with multi-app, copy the two demo routes manually:
+# apps/backend-shop/src/routes/products.ts -> GET /api/products, GET /api/products/:id
+# apps/backend-api/src/routes/users.ts    -> GET /api/users,    GET /api/users/:id
+npx nexus add frontend shop --for backend-shop
+```
+
+**What you end up with:**
+
+```
+apps/
+  backend/          # default backend from init
+  backend-shop/     # storefront API -> routes/products.ts
+  backend-api/      # shared API     -> routes/users.ts
+  frontend/         # default frontend
+  frontend-shop/    # proxies to backend-shop
+  frontend-web/     # proxies to backend
+  admin/            # single admin aggregating health/logs across all backends
+```
+
+Each `apps/backend-*` is an isolated `createNexusApp()` with its own `src/routes`, `src/ws`, `src/models`, etc. auto-discovered. Verify with `curl http://localhost:4010/api/products` and `curl http://localhost:4011/api/users` after `nexus dev` prints the port map. See `packages/nexus-examples/examples/multi-app/README.md`.
+
 ## Storage
 
 Per-backend `storage/` folder with `local` + `s3` drivers shipped:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bhooai-nexus",
-  "version": "2.0.9",
+  "version": "2.0.11",
   "description": "BhooAI Nexus - a Node-based full-stack framework (websockets, GraphQL federation, inbuilt security, custom ODM, OAuth, payments, WebRTC, AI, plugins). v2: multi-app, Laravel-style folders, Docker-based scaling.",
   "license": "MIT",
   "author": "BhooAI",

package/packages/nexus-admin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bhooai/nexus-admin",
-  "version": "2.0.11",
+  "version": "2.0.12",
   "description": "BhooAI Nexus v2 admin SPA — Apps-tab-first, live registry/health/logs/config/users/payments/AI",
   "type": "module",
   "license": "MIT",