@bleedingdev/modern-js-create 3.2.0-ultramodern.117 → 3.2.0-ultramodern.118

package/README.md

@@ -8,17 +8,13 @@
   A Progressive React Framework for modern web development.
 </p>
 
-## Getting Started
+## UltraModern.js Create
 
-Please follow [Quick Start](https://modernjs.dev/en/guides/get-started/quick-start) to get started with Modern.js.
-
-For UltraModern.js, use the BleedingDev create package. It defaults to a
-production-ready single app with `presetUltramodern(...)`, TanStack Router,
-Tailwind CSS v4, i18n, Effect BFF, generated quality gates, and published
-BleedingDev package aliases:
+The BleedingDev create package has one supported generated product: an
+UltraModern SuperApp workspace.
 
 ```bash
-pnpm dlx @bleedingdev/modern-js-create my-app
+pnpm dlx @bleedingdev/modern-js-create my-workspace
 ```
 
 To initialize the empty directory you are already in, pass `.` explicitly:
@@ -27,84 +23,43 @@ To initialize the empty directory you are already in, pass `.` explicitly:
 pnpm dlx @bleedingdev/modern-js-create .
 ```
 
-The default is the full UltraModern single-app setup. Create a SuperApp
-workspace explicitly when you need independently owned verticals:
-
-```bash
-pnpm dlx @bleedingdev/modern-js-create my-super-app --ultramodern-workspace
-```
-
 The workspace starts shell-only so the first commit has no fake business
 domains to delete. It generates:
 
 - `apps/shell-super-app` as the Module Federation host and topology owner.
-- `verticals/*` empty until you add a real domain with `--vertical`.
-- `packages/shared-*` placeholders for shared contracts, tokens, and API
-  support.
-- `.modernjs/ultramodern-generated-contract.json` with MF, Effect, i18n,
-  federated CSS, Cloudflare, route publicness, generated public-surface, and
-  Zephyr dependency metadata.
+- `verticals/*` empty until a real domain is added with `--vertical`.
+- `packages/shared-*` placeholders for shared contracts, tokens, and Effect
+  API support.
+- `.modernjs/ultramodern-generated-contract.json` with Module Federation,
+  Effect, i18n, federated CSS, Cloudflare, route publicness, generated
+  public-surface, and Zephyr dependency metadata.
 
 Validate the generated workspace before making application changes:
 
 ```bash
-cd my-super-app
+cd my-workspace
 mise install
 pnpm install
 pnpm check
 pnpm build
 ```
 
-### Router Template
-
-TanStack Router is generated by default. Choose React Router only as an explicit
-compatibility lane:
-
-```bash
-pnpm dlx @bleedingdev/modern-js-create my-app --router react-router
-```
-
-### Tailwind Template
-
-Tailwind CSS v4 setup is generated by default. Disable it explicitly when you
-need a plain CSS starter:
-
-```bash
-pnpm dlx @bleedingdev/modern-js-create my-app --no-tailwind
-```
-
-TanStack Router and Tailwind CSS work together without extra flags:
-
-```bash
-pnpm dlx @bleedingdev/modern-js-create my-app
-```
-
-### BFF Runtime Template
-
-UltraModern app scaffolds include Effect HttpApi BFF by default:
-
-```bash
-pnpm dlx @bleedingdev/modern-js-create my-app
-```
+Generated CI does not call the local aggregate. It runs format, lint,
+typecheck, skills, i18n boundary validation, contract validation, and build as
+separate matrix jobs so failures are isolated and parallelizable. Generated
+lefthook config runs separate format and lint-fix commands on pre-commit, then
+runs the read-only primitive gates in parallel on pre-push.
 
-To scaffold Hono runtime explicitly:
+For local monorepo dependency testing, add `--workspace`:
 
 ```bash
-pnpm dlx @bleedingdev/modern-js-create my-app --bff-runtime hono
+pnpm dlx @bleedingdev/modern-js-create my-workspace --workspace
 ```
 
-Generated starters expose `presetUltramodern(...)` as the public opinionated
-config wrapper when you want the full Ultramodern setup surface in
-`modern.config.ts`.
-
-TanStack Router, default Tailwind, and Effect BFF are included without extra
-flags. For local monorepo dependency testing, add `--workspace`:
-
-```bash
-pnpm dlx @bleedingdev/modern-js-create my-app --workspace
-```
+For package-source validation outside the monorepo, pass explicit
+`--ultramodern-package-*` options.
 
-### Vertical Workspace Recipes
+## Vertical Workspace Recipes
 
 Use the workspace add flow from the UltraModern workspace root. It derives the
 package path, package name, port, Module Federation name, topology entry, local
@@ -125,38 +80,23 @@ Use this decision table before adding a vertical:
 | Design tokens, primitives, generated clients, or domain-neutral utilities | Yes | Use an ordinary workspace package, not a vertical |
 | Feature composites or workflow state shared across verticals | No | Revisit ownership; do not hide it in shared code |
 
-The lower-level `--router react-router`, `--workspace`, and `--sub` flags remain
-available for compatibility and local package scaffolding, but UltraModern
-vertical additions should use `--vertical` so paths, topology, Effect BFF
-contracts, and local overlays stay consistent.
-
-See
-`docs/super-app-rfc-adr/WORKSPACE-0001-micro-vertical-workspace-scaffolding.md`
-for the canonical workspace topology and local orchestration model.
-
-The published `@bleedingdev/modern-js-create` package is the preferred
-UltraModern.js entrypoint. The lower-level `--ultramodern-*` flags remain
-available for release engineering and local package-source testing, but users
-should not need them for normal app creation.
-
-### SuperApp Architecture Contracts
+## SuperApp Architecture Contracts
 
 The generated shell owns route assembly and policy. Each vertical added with
-`--vertical` owns its route subtree, MF exposes, Effect BFF contract, generated
-client, `localisedUrls`, locale JSON, CSS layer, and Cloudflare Worker output.
-The shell consumes vertical UI through MF manifests and vertical APIs through
-generated Effect clients exported by the vertical packages.
+`--vertical` owns its route subtree, Module Federation exposes, Effect BFF
+contract, generated client, `localisedUrls`, locale JSON, CSS layer, and
+Cloudflare Worker output. The shell consumes vertical UI through Module
+Federation manifests and vertical APIs through generated Effect clients
+exported by the vertical packages.
 
 Route metadata is route-owned. Each app writes
 `src/routes/ultramodern-route-metadata` and passes
 `ultramodernLocalisedUrls` into `@modern-js/plugin-i18n`. Locale JSON is served
-from `/locales/{{lng}}/{{ns}}.json`; Czech and English routes are generated from
-the route owner, not from shell rewrites. Routes default to
+from `/locales/{{lng}}/{{ns}}.json`; Czech and English routes are generated
+from the route owner, not from shell rewrites. Routes default to
 `privateByDefault: true` and `publicnessDefault: private-app-screen`; generated
 public files use only explicit `public && indexable` route metadata, so private
-app screens publish only a disallowing `robots.txt` by default. Sitemap,
-manifest, `llms.txt`, API catalog, JSON-LD, and broad web profile/certification
-output stay omitted unless a safe public input exists.
+app screens publish only a disallowing `robots.txt` by default.
 
 CSS federation is explicit:
 
@@ -168,15 +108,8 @@ CSS federation is explicit:
 - Tailwind CSS v4 is configured per app through `@tailwindcss/postcss`.
 - Duplicate base styles are forbidden; SSR first paint depends on shared token
   CSS plus Modern/Rspack-emitted app CSS.
-- Apps should not inject remote `async-index.css` paths, hardcode remote
-  stylesheet links, or disable filename hashing to make CSS URLs predictable.
-  UltraModern SSR resolves federated CSS from build output and MF manifests so
-  generated shells and demos can keep normal hashed assets.
-
-Version switching evidence must keep UI, Effect API, CSS, i18n JSON, and MF
-manifest markers in lockstep for the same vertical version.
 
-### Cloudflare And Zephyr Proof
+## Cloudflare And Zephyr Proof
 
 Each generated workspace app has:
 
@@ -198,50 +131,27 @@ ULTRAMODERN_PUBLIC_URL_TRANSPORTATION=https://transportation.example.workers.dev
 pnpm cloudflare:proof -- --require-public-urls
 ```
 
-Without public URLs and credentials, use local `pnpm check` and `pnpm build`
+Without public URLs and credentials, use local primitive gates and `pnpm build`
 evidence only; do not claim live Cloudflare or Zephyr selection has been
 proven.
 
-### Troubleshooting
+## Troubleshooting
 
 | Symptom | Current check | Owner |
 | --- | --- | --- |
 | Package cohort mismatch | Regenerate with one package source strategy, run `mise install`, then rerun `pnpm install` from the activated shell. | Generated workspace package source metadata |
 | Install failure | Check the active Node/pnpm from `mise install`; rerun `pnpm install` after the shell sees the pinned versions. | Toolchain setup |
-| Build failure | Run `pnpm check` before `pnpm build`; fix reported format, lint, type, skill, i18n, or generated-contract failures first. | Owning package or generated contract |
+| Build failure | Run the matching primitive gate (`pnpm lint`, `pnpm typecheck`, `pnpm i18n:boundaries`, `pnpm contract:check`) before `pnpm build`; fix the owning failure first. | Owning package or generated contract |
 | Missing public URL | Set the env key from `.modernjs/ultramodern-generated-contract.json`, for example `ULTRAMODERN_PUBLIC_URL_SHELL_SUPER_APP`. | Deployment operator |
 | Cloudflare credentials | Confirm Wrangler credentials before `pnpm cloudflare:deploy`; local checks do not prove live Worker access. | Deployment operator |
 | Asset or CSS 404 | Rebuild with `pnpm build` or `pnpm cloudflare:deploy` and inspect emitted Modern/Rspack asset paths instead of hardcoding CSS URLs. | Framework/runtime asset pipeline |
 | Federation manifest failure | Run the shell and vertical build scripts, then check each deployed `/mf-manifest.json` URL used by the shell. | Module Federation owner |
 
-### Local Monorepo Testing
-
-When testing unreleased Modern.js packages from a local monorepo checkout, use
-workspace protocol dependencies:
-
-```bash
-pnpm dlx @bleedingdev/modern-js-create my-app --workspace
-```
-
-For package-source validation of the full SuperApp workspace, generate with the
-workspace package source, then run the generated contract gate:
-
-```bash
-pnpm dlx @bleedingdev/modern-js-create my-super-app --ultramodern-workspace --ultramodern-package-source workspace
-cd my-super-app
-pnpm install
-pnpm check
-```
-
-## Documentation
+## Modern.js Documentation
 
 - [English Documentation](https://modernjs.dev/en/)
 - [中文文档](https://modernjs.dev)
 
-## Contributing
-
-Please read the [Contributing Guide](https://github.com/web-infra-dev/modern.js/blob/main/CONTRIBUTING.md).
-
 ## License
 
 Modern.js is [MIT licensed](https://github.com/web-infra-dev/modern.js/blob/main/LICENSE).

package/dist/cjs/create-package-root.cjs

@@ -52,7 +52,7 @@ function resolveCreatePackageRoot(fromDir) {
     const seen = new Set();
     for (const candidate of candidates)if (!seen.has(candidate)) {
         seen.add(candidate);
-        if (external_node_fs_default().existsSync(external_node_path_default().join(candidate, 'package.json')) && external_node_fs_default().existsSync(external_node_path_default().join(candidate, 'template'))) return candidate;
+        if (external_node_fs_default().existsSync(external_node_path_default().join(candidate, 'package.json')) && external_node_fs_default().existsSync(external_node_path_default().join(candidate, 'template-workspace'))) return candidate;
     }
     throw new Error('Unable to resolve create package root');
 }