@bleedingdev/modern-js-main-doc 3.2.0-ultramodern.116 → 3.2.0-ultramodern.118

package/docs/en/components/init-app.mdx

@@ -1,4 +1,6 @@
-UltraModern.js provides the BleedingDev create package to create projects. It does not require global installation and can be run on-demand using `pnpm dlx`.
+UltraModern.js provides the BleedingDev create package to create SuperApp
+workspaces. It does not require global installation and can be run on-demand
+using `pnpm dlx`.
 
 You can initialize the empty directory you are already in:
 
@@ -10,33 +12,13 @@ pnpm dlx @bleedingdev/modern-js-create .
 You can also create a project directly in a new directory:
 
 ```bash
-pnpm dlx @bleedingdev/modern-js-create myapp
-```
-
-TanStack Router is scaffolded by default. To force React Router compatibility:
-
-```bash
-pnpm dlx @bleedingdev/modern-js-create myapp --router react-router
-```
-
-Tailwind CSS v4 is scaffolded by default. To opt out:
-
-```bash
-pnpm dlx @bleedingdev/modern-js-create myapp --no-tailwind
-```
-
-Effect HttpApi BFF is scaffolded by default.
-
-To initialize BFF scaffold with Hono runtime:
-
-```bash
-pnpm dlx @bleedingdev/modern-js-create myapp --bff-runtime hono
+pnpm dlx @bleedingdev/modern-js-create my-super-app
 ```
 
 To initialize with workspace protocol dependencies (for local monorepo testing of unreleased Modern.js packages):
 
 ```bash
-pnpm dlx @bleedingdev/modern-js-create myapp --workspace
+pnpm dlx @bleedingdev/modern-js-create my-super-app --workspace
 ```
 
 The BleedingDev create package will directly create the application without providing an interactive Q & A interface:
@@ -44,7 +26,7 @@ The BleedingDev create package will directly create the application without prov
 ```bash
 🚀 Welcome to UltraModern.js
 
-📦 Creating project "myapp"...
+📦 Creating project "my-super-app"...
 
 ✨ Project created successfully! 🎉
 
@@ -52,7 +34,7 @@ The BleedingDev create package will directly create the application without prov
 
 📁 Enter the project directory:
 
-  cd myapp
+  cd my-super-app
 
 🔧 Initialize Git repository:
 
@@ -71,37 +53,23 @@ Now, the project structure is as follows:
 
 ```
 .
-├── biome.json
-├── modern.config.ts
+├── apps
+│   └── shell-super-app
 ├── package.json
-├── README.md
-├── src
-│   ├── modern-app-env.d.ts
-│   ├── modern.runtime.ts
-│   └── routes
-│       ├── index.css
-│       ├── layout.tsx
-│       └── page.tsx
-└── tsconfig.json
-```
-
-Tailwind CSS v4 is generated by default; pass `--no-tailwind` to omit `postcss.config.mjs`, `tailwind.config.ts`, and the Tailwind import.
-
-By default, `modern.config.ts` enables `@modern-js/plugin-bff`, generates `api/effect/index.ts` + `shared/effect/api.ts`, and sets `bff.runtimeFramework` to `effect`.
-When `--bff-runtime hono` is enabled, `modern.config.ts` enables `@modern-js/plugin-bff`, generates `api/lambda/hello.ts`, and sets `bff.runtimeFramework` to `hono`.
-When `--workspace` is enabled, `@modern-js/*` dependencies use `workspace:*` versions for local monorepo linkage.
-
-It creates a simple production-ready UltraModern app by default and installs
-the published BleedingDev package aliases:
-
-```bash
-pnpm dlx @bleedingdev/modern-js-create myapp
+├── packages
+│   ├── shared-contracts
+│   ├── shared-design-tokens
+│   └── shared-effect-client
+├── scripts
+├── topology
+└── verticals
 ```
 
-Create a SuperApp workspace only when you need independently owned verticals:
+The default workspace starts shell-only and installs the published BleedingDev
+package aliases:
 
 ```bash
-pnpm dlx @bleedingdev/modern-js-create my-super-app --ultramodern-workspace
+pnpm dlx @bleedingdev/modern-js-create my-super-app
 ```
 
 From a generated SuperApp workspace, add a business MicroVertical in place:

package/docs/en/guides/get-started/ultramodern.mdx

@@ -39,8 +39,8 @@ UltraModern.js additions are designed as the default product surface for new Sup
 | MF vertical loading reliability | Retry/fallback patterns are often implemented per app | Adds deterministic timeout/network/contract-error reliability matrix and distributed OTEL continuity tests |
 | Module onboarding governance | No module-certification evidence profile in baseline | Adds module SDK contracts, boundary anti-pattern guards, and release/module certification gate workflows |
 | Router runtime | Default runtime path centers on React Router | Adds first-class TanStack Router runtime/CLI path (React Router remains supported) |
-| Scaffolding templates | Default create templates center on React Router starter path | Adds TanStack-ready and Tailwind-ready create templates |
-| Starter preset enforcement | No generated UltraModern preset gate workflow | Generated starters include `ultramodern:check`, opt-out env switches, and `.github/workflows/ultramodern-gates.yml` |
+| Scaffolding templates | Default create templates center on React Router starter path | Generates a SuperApp workspace by default with TanStack, Effect, Module Federation, i18n, Tailwind, Cloudflare, and ownership contracts |
+| Workspace preset enforcement | No generated UltraModern preset gate workflow | Generated workspaces include `.github/workflows/ultramodern-workspace-gates.yml`, `pnpm check`, primitive local gates, and generated contract validation |
 
 ## What We Intentionally Do Not Change
 
@@ -56,33 +56,24 @@ For teams already on Modern.js 3.0, the adoption path remains compatibility-awar
 1. Keep existing React Router apps running as-is. TanStack Router is the preferred path for new scaffolds and incremental route adoption, but the React Router lane remains supported while teams move on their own schedule.
 2. Prefer `bff.runtimeFramework: 'effect'` for new BFF work, with the entry implemented at `api/effect/index.ts`. If your app already uses Hono handlers under `api/lambda/**`, keep `bff.runtimeFramework: 'hono'` until you are ready to move them; Hono remains a supported compatibility lane.
 3. Treat the baseline contracts as progressive defaults, not a forced cutover. `MODERN_BASELINE_ENABLE_MF_SSR`, `MODERN_BASELINE_ENABLE_BFF_REQUEST_ID`, and `MODERN_BASELINE_ENABLE_TELEMETRY_EXPORTERS` already let each app opt out while it converges on the preferred stack.
-4. The public preset now ships with explicit release and certification gates. The generated starter also ships `.github/workflows/ultramodern-gates.yml`, so `pnpm run ultramodern:check` and `pnpm run build` stay part of the adoption contract from day one.
+4. The public preset now ships with explicit release and certification gates. Generated workspaces include `.github/workflows/ultramodern-workspace-gates.yml`, so `pnpm check` and `pnpm build` stay part of the local adoption contract from day one while CI runs the primitive gates as parallel matrix jobs.
 
 This page is not a migration guide or codemod plan. Migration guidance for existing applications is intentionally deferred from the current Micro Verticals framework scope.
 
 ## Human Workflow
 
-The public BleedingDev create package starts small. The default command creates
-one production-ready UltraModern app with `presetUltramodern(...)`, SSR,
-TanStack Router, Tailwind CSS v4, i18n, Effect BFF, generated quality gates, and
-Cloudflare deploy basics:
+The public BleedingDev create package has one supported generated product. The
+default command creates a production-ready UltraModern SuperApp workspace with
+`presetUltramodern(...)`, SSR, TanStack Router, Tailwind CSS v4, i18n, Effect
+BFF, Module Federation topology, generated quality gates, and Cloudflare deploy
+basics:
 
 ```bash
 pnpm dlx @bleedingdev/modern-js-create myapp
 cd myapp
 mise install
 mise exec -- pnpm install
-mise exec -- pnpm ultramodern:check
-```
-
-Create a SuperApp workspace only when independent ownership is useful:
-
-```bash
-pnpm dlx @bleedingdev/modern-js-create my-super-app --ultramodern-workspace
-cd my-super-app
-mise install
-mise exec -- pnpm install
-mise exec -- pnpm ultramodern:check
+mise exec -- pnpm check
 ```
 
 The workspace starts from a shell and generated platform contracts. It does not
@@ -94,7 +85,7 @@ pnpm dlx @bleedingdev/modern-js-create transportation --vertical
 pnpm dlx @bleedingdev/modern-js-create food-delivery --vertical
 pnpm dlx @bleedingdev/modern-js-create payments --vertical
 pnpm dlx @bleedingdev/modern-js-create maps --vertical
-mise exec -- pnpm ultramodern:check
+mise exec -- pnpm check
 ```
 
 The `--vertical` command mutates the current workspace. It creates the vertical
@@ -132,7 +123,7 @@ Version switching must select UI, Effect API, CSS, i18n JSON, and MF manifest ev
 Local gates:
 
 ```bash
-mise exec -- pnpm ultramodern:check
+mise exec -- pnpm check
 mise exec -- pnpm build
 mise exec -- pnpm cloudflare:build
 ```

package/package.json

@@ -18,14 +18,14 @@
     "modern",
     "modern.js"
   ],
-  "version": "3.2.0-ultramodern.116",
+  "version": "3.2.0-ultramodern.118",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
   "dependencies": {
     "mermaid": "^11.15.0",
-    "@modern-js/sandpack-react": "npm:@bleedingdev/modern-js-sandpack-react@3.2.0-ultramodern.116"
+    "@modern-js/sandpack-react": "npm:@bleedingdev/modern-js-sandpack-react@3.2.0-ultramodern.118"
   },
   "devDependencies": {
     "@rsbuild/plugin-sass": "1.5.3",