@bleedingdev/modern-js-ultramodern-create 3.9.0-ultramodern.9 → 3.9.3-ultramodern.2

package/README.md

@@ -1,23 +1,19 @@
-<p align="center">
-  <a href="https://modernjs.dev" target="blank"><img src="https://lf3-static.bytednsdoc.com/obj/eden-cn/ylaelkeh7nuhfnuhf/modernjs-cover.png" width="300" alt="Modern.js Logo" /></a>
-</p>
+# UltraModern.js Create
 
-<h1 align="center">Modern.js</h1>
+Create an UltraModern.js workspace with React, Solid 2, or Octane. React is the
+default SuperApp profile; Solid and Octane provide standalone Node SSR and CSR
+preview profiles with their native authoring and router APIs.
 
-<p align="center">
-  A Progressive React Framework for modern web development.
-</p>
-
-## UltraModern.js Create
-
-The BleedingDev create package has one supported generated product: an UltraModern SuperApp workspace. New scaffolds use TanStack Router.
+Replace `<V>` with the exact published UltraModern package cohort version:
 
 ```bash
-pnpm dlx @bleedingdev/modern-js-ultramodern-create my-workspace
+pnpm dlx @bleedingdev/modern-js-ultramodern-create@<V> my-workspace
+pnpm dlx @bleedingdev/modern-js-ultramodern-create@<V> my-solid-workspace --renderer solid
+pnpm dlx @bleedingdev/modern-js-ultramodern-create@<V> my-octane-workspace --renderer octane
 ```
 
 The supported pnpm command contract is the scoped package specifier above:
-`pnpm dlx @bleedingdev/modern-js-ultramodern-create <target>`. Do not shorten it
+`pnpm dlx @bleedingdev/modern-js-ultramodern-create@<V> <target>`. Do not shorten it
 to `pnpm dlx modern-js-ultramodern-create`; there is no unscoped
 `modern-js-ultramodern-create` npm package. Release proof runs this scoped form
 from a temporary pnpm store/cache so it cannot pass because of a local link
@@ -26,18 +22,51 @@ cache.
 To initialize the empty directory you are already in, pass `.` explicitly:
 
 ```bash
-pnpm dlx @bleedingdev/modern-js-ultramodern-create .
+pnpm dlx @bleedingdev/modern-js-ultramodern-create@<V> .
+```
+
+## Renderer Selection
+
+`--renderer react|solid|octane` selects the initial scaffold only. Existing
+workspace additions read the renderer from the owning `modern.config.ts` and
+reject `--renderer`. That config is the single selector for the compiler,
+runtime, router, and generated entries:
+
+```ts
+import { defineConfig } from '@modern-js/ultramodern-app-tools';
+
+export default defineConfig({
+  renderer: 'solid',
+  server: { ssr: true },
+});
 ```
 
+Restart the dev server after changing `renderer`, and author app sources for
+the selected renderer. `defineConfig` selects the native compiler; do not add
+a second compiler or base app-tools plugin.
+
+| Renderer | Application authoring | Router imports |
+| --- | --- | --- |
+| Solid 2 RC | `solid-js`, `@solidjs/web` | `@modern-js/renderer-solid/router` |
+| Octane | `octane` | `@modern-js/renderer-octane/router` |
+
+Solid and Octane previews support plain Node SSR with hydration and CSR. They
+require the admitted package cohort and reject unsupported capabilities:
+Module Federation, Worker deployment, RSC, SSG, framework i18n, SVG component
+imports, and CSS declaration emission beside authored source. There is no CLI
+preview override. The SuperApp federation and
+Cloudflare guidance below applies to the React profile.
+
 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.
+- `apps/shell-super-app` as the initial app and topology owner; React also
+  makes it the Module Federation host.
 - `verticals/*` empty until a real domain is added with `--vertical`.
 - `packages/shared-*` placeholders for shared contracts, tokens, and Effect
 API support.
-- `.modernjs/ultramodern.json` as compact generator provenance, package-source
-  config, app topology, bridge, deploy, Module Federation, and tooling config.
+- `catalogs.ultramodern` in `pnpm-workspace.yaml` for published framework
+  dependency versions, referenced by application manifests.
 - `topology/*` as app-owned topology, ownership, and local development overlay
   JSON.
 
@@ -51,15 +80,26 @@ pnpm check
 pnpm build
 ```
 
-The generated toolchain pins Node `26.7.0`, pnpm `11.24.0`, and
-`@types/node@^26.4.1`; its engine baseline remains Node `>=26` with pnpm `11+`.
+Start the shell during development, or serve its production build:
+
+```bash
+pnpm dev:shell
+pnpm --filter "./apps/shell-super-app" serve
+```
+
+Run these as separate commands. Use the matching app directory in the filter
+to serve an added app.
+
+The generated toolchain pins Node `26.10.0`, pnpm `12.8.1`, and
+`@types/node@26.6.4`; the generator requires Node `>=26.10.0`, and generated
+workspaces declare an engine baseline of Node `>=26` with pnpm `12+`.
 `packageManager`, `.mise.toml`, generated validation, and CI should all agree
 on those values; do not reintroduce Corepack or older pnpm aliases.
 
-The current generated dependency cohort also pins `@effect/tsgo@0.41.0`,
-`@tanstack/react-router@1.170.33`, `@tanstack/router-core@1.171.28`,
-`@tanstack/history@1.162.2`, and the Module Federation integration `2.9.0`
-cohort, `@module-federation/node@2.7.50`. Move these only through the
+The current React dependency cohort also pins `@effect/tsgo@0.45.0`,
+`@tanstack/react-router@1.170.41`, `@tanstack/router-core@1.171.34`,
+`@tanstack/history@1.162.4`, and the Module Federation integration `2.9.2`
+cohort, `@module-federation/node@2.7.52`. Move these only through the
 generator-owned version policy so templates, validation, and the published
 workspace contract stay aligned.
 
@@ -86,12 +126,14 @@ stays active during `rslib build --watch`. Run
 includes a boundary test that scans generator sources, templates, and generated
 workspace output for compiler API imports.
 
-Generated app packages keep stable `typescript` on TS7 so Modern/Rspack and
-`@effect/tsgo` use TS-Go by default. Generated app/package source must not
+All renderer profiles use exact stable `typescript@7.0.2`. React and Solid apps
+use the generated TS-Go check; Octane apps use `octane-tsc` with their native
+TS7 checker. Modern/Rspack and `@effect/tsgo` also use TS-Go by default.
+Generated app/package source must not
 depend on compiler API internals. If a future AST utility is needed, keep it
 behind a dedicated TypeScript adapter and test it against stable `typescript`.
 
-Generated CI does not call the local aggregate. It runs format, lint,
+Generated React 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
@@ -100,7 +142,7 @@ runs the read-only primitive gates in parallel on pre-push.
 For local monorepo dependency testing, add `--workspace`:
 
 ```bash
-pnpm dlx @bleedingdev/modern-js-ultramodern-create my-workspace --workspace
+pnpm dlx @bleedingdev/modern-js-ultramodern-create@<V> my-workspace --workspace
 ```
 
 For package-source validation outside the monorepo, pass explicit
@@ -119,26 +161,26 @@ import {
   planUltramodernVertical,
 } from '@modern-js/ultramodern-create/ultramodern-workspace';
 
-const workspace = generateUltramodernWorkspace({
+const workspace = await generateUltramodernWorkspace({
   targetDir: '/tmp/my-workspace',
   packageName: 'my-workspace',
-  modernVersion: '3.4.0',
+  modernVersion: '<V>',
   packageSource: {
     strategy: 'install',
-    modernPackageVersion: '3.4.0',
+    modernPackageVersion: '<V>',
   },
 });
 
-const plan = planUltramodernVertical({
+const plan = await planUltramodernVertical({
   workspaceRoot: workspace.workspaceRoot,
   name: 'new-vertical',
-  modernVersion: '3.4.0',
+  modernVersion: '<V>',
 });
 
-const vertical = addUltramodernVertical({
+const vertical = await addUltramodernVertical({
   workspaceRoot: workspace.workspaceRoot,
   name: 'new-vertical',
-  modernVersion: '3.4.0',
+  modernVersion: '<V>',
 });
 ```
 
@@ -148,13 +190,13 @@ Workspace generation returns `operation`, `workspaceRoot`, `packageScope`,
 `generatedContractPath`, and `warnings`. MicroVertical addition returns the
 same shape for the new vertical and all rewritten integration surfaces.
 
-Dry-run is available for MicroVertical addition only. The CLI prints the plan as
+MicroVertical addition supports dry-run. The CLI prints the plan as
 JSON and writes no files:
 
 ```bash
-pnpm dlx @bleedingdev/modern-js-ultramodern-create new-vertical --vertical --dry-run
-pnpm dlx @bleedingdev/modern-js-ultramodern-create --vertical=new-vertical --dry-run
-pnpm dlx @bleedingdev/modern-js-ultramodern-create --vertical-name new-vertical --dry-run
+pnpm dlx @bleedingdev/modern-js-ultramodern-create@<V> new-vertical --vertical --dry-run
+pnpm dlx @bleedingdev/modern-js-ultramodern-create@<V> --vertical=new-vertical --dry-run
+pnpm dlx @bleedingdev/modern-js-ultramodern-create@<V> --vertical-name new-vertical --dry-run
 ```
 
 The dry-run object adds `dryRun: true`, `selectedPort`,
@@ -162,45 +204,49 @@ The dry-run object adds `dryRun: true`, `selectedPort`,
 `shellDependencyChanges`, and `generatedContractChanges`. It still validates
 the workspace before returning a plan.
 
-Validation runs before the first filesystem write. Failures name the owning
+Validation runs before publishing generated output to the target workspace.
+Failures name the owning
 contract so automation can stop safely:
 
 | Failure area | Typical cause | Fix |
 | --- | --- | --- |
 | Fresh input | Invalid or missing vertical name | Use `<name> --vertical`, `--vertical=<name>`, or `--vertical-name <name>` |
 | Existing topology | Duplicate app ID, package suffix, path, Module Federation name, port, API prefix, or manifest key | Choose a new vertical name or repair the existing topology/local overlay first |
-| Workspace files | Missing or non-object compact UltraModern config, topology, ownership, or local overlay JSON | Restore the generated config files from source control or rerun from a valid workspace |
+| Workspace files | Missing or invalid topology, ownership, local overlay or app manifest | Repair the named authoritative file |
 | Tailwind prefix | Existing app already owns the generated CSS prefix | Rename the vertical before generation |
 | Output path | A generated path already exists | Treat it as an existing vertical and do not overwrite it |
 
-Package source is explicit and recorded in `.modernjs/ultramodern.json`.
+Package source is selected by the installed generator dependency and native pnpm catalog.
+Application manifests own package identity; the development overlay owns local ports.
 
 | Strategy | Use when | CLI |
 | --- | --- | --- |
 | `install` | Published BleedingDev package cohort or release proof | Default for the BleedingDev create package; optional `--ultramodern-package-version`, `--ultramodern-package-registry` (serves the cohort scope only; release-age metadata for every other dependency is validated against npmjs), `--ultramodern-package-scope`, and `--ultramodern-package-name-prefix` |
 | `workspace` | Local monorepo testing against unreleased packages | `--workspace` or `--ultramodern-package-source=workspace` |
 
-## Framework Cohort
-
-Generated strict Effect workspaces pin the compatible Effect cohort through
-`pnpm-workspace.yaml` overrides: `effect@4.0.0-rc.112`,
-`@effect/opentelemetry@4.0.0-rc.112`, and
-`@effect/vitest@4.0.0-rc.112` (requiring `vitest >=4.1.0 <5`). The strict
-24-hour release-age gate applies to the installed cohort; the current policy carries no Effect age exemption, and
-the override-only `@effect/vitest` entry is not an installed approval target.
-Separately, exact
-`trustPolicyExclude` entries for `effect` and `@effect/opentelemetry` cover the
-trusted-publisher to provenance transition. Trust exclusions are not
-release-age approvals. Do not override the cohort in app packages; update the
-framework cohort when the runtime moves.
-
-Use `--ultramodern-package-source=install` for published cohort proof and pin a
-specific release with `--ultramodern-package-version` when CI must prove an
-exact framework version. Keep `--workspace` only for local monorepo testing
-against unpublished packages. After install, run the generated
-`scripts/validate-ultramodern-workspace.mts` contract check and fix ownership
-conflicts in the owning JSON/config files instead of editing generated metadata
-by hand.
+## Framework dependencies
+
+Published framework versions live in `catalogs.ultramodern` in
+`pnpm-workspace.yaml`. Application manifests reference `catalog:ultramodern`;
+the lockfile records resolved packages. Corrected third-party dependencies ship
+as published packages. Applications do not install framework patches or carry
+a copied release manifest.
+
+Use `--ultramodern-package-source=install` for published package acceptance and
+`--ultramodern-package-version` to select an exact release. Use `--workspace`
+for local monorepo development. After installation, run `pnpm contract:check`,
+which invokes the installed CLI directly. The installed generator owns its
+release-integrity metadata.
+
+Normal installs retain the generated strict 24-hour release-age and trust
+policy. The one exception is `minimumReleaseAgeExclude`: it lists the exact
+`package@version` of every package in the cohort the create package ships, so a
+workspace created on the day that cohort is published can install it. Every
+other dependency still waits 24 hours, including a cohort selected with
+`--ultramodern-package-version` that differs from the create package's own; to
+install a fresh cohort on publish day, run that release's create package.
+Release acceptance adds exact, temporary exceptions for the sidecars under test
+on the command line.
 
 ## CodeSmith Adapter And Overlays
 
@@ -218,9 +264,9 @@ await ultramodernCodeSmith({
     mode: 'workspace',
     name: 'my-workspace',
     targetDir: '/tmp/my-workspace',
-    modernVersion: '3.4.0',
+    modernVersion: '<V>',
     packageSourceStrategy: 'install',
-    modernPackageVersion: '3.4.0',
+    modernPackageVersion: '<V>',
   },
 });
 
@@ -243,15 +289,15 @@ Overlays are explicit CodeSmith generators that run after base workspace or
 MicroVertical generation:
 
 ```bash
-pnpm dlx @bleedingdev/modern-js-ultramodern-create new-vertical --vertical \
+pnpm dlx @bleedingdev/modern-js-ultramodern-create@<V> new-vertical --vertical \
   --codesmith-overlay ./generators/vertical-overlay
 ```
 
 ```ts
-addUltramodernVertical({
+await addUltramodernVertical({
   workspaceRoot: '/tmp/my-workspace',
   name: 'new-vertical',
-  modernVersion: '3.4.0',
+  modernVersion: '<V>',
   overlays: [
     {
       generator: './generators/vertical-overlay',
@@ -278,9 +324,9 @@ overlay, ownership entry, strict Effect HttpApi surface, and root `dev:*` script
 requested vertical name.
 
 ```bash
-pnpm dlx @bleedingdev/modern-js-ultramodern-create catalog --vertical
-pnpm dlx @bleedingdev/modern-js-ultramodern-create --vertical=catalog
-pnpm dlx @bleedingdev/modern-js-ultramodern-create --vertical-name catalog
+pnpm dlx @bleedingdev/modern-js-ultramodern-create@<V> catalog --vertical
+pnpm dlx @bleedingdev/modern-js-ultramodern-create@<V> --vertical=catalog
+pnpm dlx @bleedingdev/modern-js-ultramodern-create@<V> --vertical-name catalog
 ```
 
 Use this decision table before adding a vertical:
@@ -295,7 +341,24 @@ Use this decision table before adding a vertical:
 
 ## SuperApp Architecture Contracts
 
-The generated shell owns route assembly and policy. Each vertical added with
+Generated React `modern.config.ts` files declare their app identity through
+`presetUltramodernWorkspace(config, { appId, from: import.meta.url })` inside
+the renderer-selecting `defineConfig` from `@modern-js/ultramodern-app-tools`,
+and keep ordinary Modern.js plugins and authored configuration. The preset
+resolves `topology/reference-topology.json` and the development overlay when
+the config loads. Fork-owned packages apply deployment targets, ports, asset
+origins, CORS, Cloudflare bindings, build/cache directories, release identity,
+and Zephyr deployment policy. Authored values override preset defaults; native
+builder hooks and plugins compose normally. Solid and Octane apps select their
+renderer directly with `defineConfig({ renderer })`.
+
+Adding a shell or vertical updates topology, overlays, and generated workspace
+metadata without rewriting any existing `modern.config.ts`. Application
+configs belong to their authors from the moment they are created. New apps
+receive a config scaffold with their own stable `appId`; changing a port or
+shell composition takes effect through the canonical workspace inputs.
+
+The React SuperApp shell owns route assembly and policy. Each React vertical added with
 `--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
@@ -303,10 +366,11 @@ Federation manifests and vertical APIs through generated Effect clients
 exported by the vertical packages.
 
 Route metadata is route-owned and colocated in
-`src/routes/**/route.meta.ts`. The scaffold regenerates
-`src/routes/ultramodern-route-metadata.ts` as a generated route manifest for
-Modern.js config, i18n, public head, and public surface contracts; authors
-should not hand-maintain it. Locale JSON is served from
+`src/routes/**/route.meta.ts`; each file exports `routeMeta`.
+`ultramodern-create ultramodern routes-generate` (run before every app `dev`
+and `build`) regenerates `src/routes/ultramodern-route-metadata.ts` as a
+formatted route manifest for Modern.js config, i18n, public head, and public
+surface contracts; authors should not hand-maintain it. Locale JSON is served from
 `/locales/{{lng}}/{{ns}}.json`; Czech and English routes are generated from the
 route owner, not from shell rewrites.
 
@@ -375,17 +439,18 @@ where assets load from.
 
 ## Cloudflare And Zephyr Proof
 
-Each generated workspace app has:
+Each generated React workspace app has:
 
 - `cloudflare:build`, `cloudflare:deploy`, `cloudflare:preview`, and
   `cloudflare:proof` scripts.
-- Cloudflare Worker deploy config from Modern config plus
-  `.modernjs/ultramodern.json`.
+- Cloudflare Worker deploy config emitted from native Modern config.
 - `zephyr:dependencies` for any consumed verticals.
-- `zephyr-rspack-plugin` wired through the generated Modern.js Rspack bridge.
+- `zephyr-rspack-plugin` composed by the fork-owned workspace preset for UI
+  apps. It activates only when `ZE_CI_TOKEN` is present; the deploy environment
+  must also set `ZE_FAIL_BUILD=true`. Ordinary builds require no Zephyr token.
 
 Deploy first, then pass each deployed app's generated public URL env key into
-the proof step. The proof script reads the compact UltraModern config and checks the
+the proof step. The installed proof command reads topology and deployment contracts and checks the
 Cloudflare Worker surface, including public-route sitemap/robots consistency,
 preview noindex behavior, unknown-route status, asset headers, byte budgets,
 and public sourcemap exposure. Shell-only workspaces only need the shell URL;
@@ -407,10 +472,10 @@ proven.
 
 | 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 |
+| Package version mismatch | Align the native framework catalog and regenerate the lockfile with `pnpm install`. | Workspace dependency manifests |
 | 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 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 app public URL env key recorded in `.modernjs/ultramodern.json`, for example `ULTRAMODERN_PUBLIC_URL_SHELL_SUPER_APP`. | Deployment operator |
+| Missing public URL | Set the app public URL env key declared in topology, 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 |

package/dist/cjs/cli/flags.cjs

@@ -33,6 +33,7 @@ __webpack_require__.d(__webpack_exports__, {
     DRY_RUN_FLAG: ()=>DRY_RUN_FLAG,
     HORIZONTAL_REMOTE_FLAG: ()=>HORIZONTAL_REMOTE_FLAG,
     PRESET_FLAG: ()=>PRESET_FLAG,
+    RENDERER_FLAG: ()=>RENDERER_FLAG,
     VERTICAL_FLAG: ()=>VERTICAL_FLAG,
     WORKSPACE_PROTOCOL_FLAG: ()=>WORKSPACE_PROTOCOL_FLAG,
     collectPositionalArgs: ()=>collectPositionalArgs,
@@ -44,6 +45,7 @@ __webpack_require__.d(__webpack_exports__, {
     detectHorizontalRemoteFlag: ()=>detectHorizontalRemoteFlag,
     detectLanguage: ()=>detectLanguage,
     detectPresetFlag: ()=>detectPresetFlag,
+    detectRendererFlag: ()=>detectRendererFlag,
     detectTailwindFlag: ()=>detectTailwindFlag,
     getOptionValue: ()=>getOptionValue,
     readBridgeCliOptions: ()=>readBridgeCliOptions,
@@ -51,6 +53,7 @@ __webpack_require__.d(__webpack_exports__, {
 });
 const index_cjs_namespaceObject = require("../locale/index.cjs");
 const bridge_config_cjs_namespaceObject = require("../ultramodern-workspace/bridge-config.cjs");
+const renderer_profile_cjs_namespaceObject = require("../ultramodern-workspace/renderer-profile.cjs");
 const WORKSPACE_PROTOCOL_FLAG = '--workspace';
 const DRY_RUN_FLAG = '--dry-run';
 const VERTICAL_FLAG = '--vertical';
@@ -59,6 +62,7 @@ const CODESMITH_OVERLAY_FLAG = '--codesmith-overlay';
 const PRESET_FLAG = '--preset';
 const API_PROTOCOL_FLAG = '--api-protocol';
 const HORIZONTAL_REMOTE_FLAG = '--horizontal-remote';
+const RENDERER_FLAG = '--renderer';
 const SUPPORTED_PRESETS = [
     'full-stack',
     'api-only',
@@ -123,6 +127,7 @@ function collectPositionalArgs(args) {
     const optionWithValue = new Set([
         '--lang',
         '-l',
+        RENDERER_FLAG,
         BFF_RUNTIME_OPTION,
         '--ultramodern-package-source',
         '--ultramodern-package-version',
@@ -158,7 +163,7 @@ function collectPositionalArgs(args) {
                 i += 1;
                 continue;
             }
-            if (!(arg.startsWith('--lang=') || arg.startsWith(`${BFF_RUNTIME_OPTION}=`) || arg.startsWith('--ultramodern-package-source=') || arg.startsWith('--ultramodern-package-version=') || arg.startsWith('--ultramodern-package-registry=') || arg.startsWith('--ultramodern-package-scope=') || arg.startsWith('--ultramodern-package-name-prefix=') || arg.startsWith(`${VERTICAL_FLAG}=`) || arg.startsWith(`${VERTICAL_NAME_FLAG}=`) || arg.startsWith(`${CODESMITH_OVERLAY_FLAG}=`) || arg.startsWith(`${PRESET_FLAG}=`) || arg.startsWith(`${API_PROTOCOL_FLAG}=`) || bridge_config_cjs_namespaceObject.ultramodernBridgeCliBooleanFlags.some((flag)=>arg.startsWith(`${flag}=`)) || bridge_config_cjs_namespaceObject.ultramodernBridgeCliValueFlags.some((flag)=>arg.startsWith(`${flag}=`)))) positionalArgs.push(arg);
+            if (!(arg.startsWith('--lang=') || arg.startsWith(`${RENDERER_FLAG}=`) || arg.startsWith(`${BFF_RUNTIME_OPTION}=`) || arg.startsWith('--ultramodern-package-source=') || arg.startsWith('--ultramodern-package-version=') || arg.startsWith('--ultramodern-package-registry=') || arg.startsWith('--ultramodern-package-scope=') || arg.startsWith('--ultramodern-package-name-prefix=') || arg.startsWith(`${VERTICAL_FLAG}=`) || arg.startsWith(`${VERTICAL_NAME_FLAG}=`) || arg.startsWith(`${CODESMITH_OVERLAY_FLAG}=`) || arg.startsWith(`${PRESET_FLAG}=`) || arg.startsWith(`${API_PROTOCOL_FLAG}=`) || bridge_config_cjs_namespaceObject.ultramodernBridgeCliBooleanFlags.some((flag)=>arg.startsWith(`${flag}=`)) || bridge_config_cjs_namespaceObject.ultramodernBridgeCliValueFlags.some((flag)=>arg.startsWith(`${flag}=`)))) positionalArgs.push(arg);
         }
     }
     return positionalArgs;
@@ -245,6 +250,21 @@ function detectDryRunFlag(args) {
     }
     return args.includes(DRY_RUN_FLAG);
 }
+function detectRendererFlag(args) {
+    const requested = args.some((arg)=>arg === RENDERER_FLAG || arg.startsWith(`${RENDERER_FLAG}=`));
+    if (!requested) return;
+    const renderer = getOptionValue(args, [
+        RENDERER_FLAG
+    ]);
+    if (!(0, renderer_profile_cjs_namespaceObject.isApplicationRenderer)(renderer)) throw new Error(`${RENDERER_FLAG} requires react, solid or octane.`);
+    const values = args.flatMap((arg, index)=>arg === RENDERER_FLAG ? [
+            args[index + 1]
+        ] : arg.startsWith(`${RENDERER_FLAG}=`) ? [
+            arg.slice(`${RENDERER_FLAG}=`.length)
+        ] : []);
+    if (values.some((value)=>value !== renderer)) throw new Error('Conflicting renderer selections. Choose one renderer when creating the workspace.');
+    return renderer;
+}
 function detectCodeSmithOverlays(args) {
     const overlays = [];
     for(let i = 0; i < args.length; i++){
@@ -316,6 +336,7 @@ exports.CODESMITH_OVERLAY_FLAG = __webpack_exports__.CODESMITH_OVERLAY_FLAG;
 exports.DRY_RUN_FLAG = __webpack_exports__.DRY_RUN_FLAG;
 exports.HORIZONTAL_REMOTE_FLAG = __webpack_exports__.HORIZONTAL_REMOTE_FLAG;
 exports.PRESET_FLAG = __webpack_exports__.PRESET_FLAG;
+exports.RENDERER_FLAG = __webpack_exports__.RENDERER_FLAG;
 exports.VERTICAL_FLAG = __webpack_exports__.VERTICAL_FLAG;
 exports.WORKSPACE_PROTOCOL_FLAG = __webpack_exports__.WORKSPACE_PROTOCOL_FLAG;
 exports.collectPositionalArgs = __webpack_exports__.collectPositionalArgs;
@@ -327,6 +348,7 @@ exports.detectExplicitTailwindFlag = __webpack_exports__.detectExplicitTailwindF
 exports.detectHorizontalRemoteFlag = __webpack_exports__.detectHorizontalRemoteFlag;
 exports.detectLanguage = __webpack_exports__.detectLanguage;
 exports.detectPresetFlag = __webpack_exports__.detectPresetFlag;
+exports.detectRendererFlag = __webpack_exports__.detectRendererFlag;
 exports.detectTailwindFlag = __webpack_exports__.detectTailwindFlag;
 exports.getOptionValue = __webpack_exports__.getOptionValue;
 exports.readBridgeCliOptions = __webpack_exports__.readBridgeCliOptions;
@@ -337,6 +359,7 @@ for(var __rspack_i in __webpack_exports__)if (-1 === [
     "DRY_RUN_FLAG",
     "HORIZONTAL_REMOTE_FLAG",
     "PRESET_FLAG",
+    "RENDERER_FLAG",
     "VERTICAL_FLAG",
     "WORKSPACE_PROTOCOL_FLAG",
     "collectPositionalArgs",
@@ -348,6 +371,7 @@ for(var __rspack_i in __webpack_exports__)if (-1 === [
     "detectHorizontalRemoteFlag",
     "detectLanguage",
     "detectPresetFlag",
+    "detectRendererFlag",
     "detectTailwindFlag",
     "getOptionValue",
     "readBridgeCliOptions",

package/dist/cjs/cli/help.cjs

@@ -54,6 +54,7 @@ function showHelp() {
     console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionHelp));
     console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionVersion));
     console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionLang));
+    console.log('  --renderer <react|solid|octane>  Select the native application renderer.');
     console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionTailwind));
     console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionBff));
     console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionBffRuntime));

package/dist/cjs/index.cjs

@@ -78,6 +78,8 @@ async function main() {
     (0, flags_cjs_namespaceObject.detectBffRuntime)(args);
     const dryRun = (0, flags_cjs_namespaceObject.detectDryRunFlag)(args);
     const verticalInput = (0, flags_cjs_namespaceObject.resolveVerticalCliInput)(args);
+    const renderer = (0, flags_cjs_namespaceObject.detectRendererFlag)(args);
+    if (verticalInput.addVertical && renderer) throw new Error('Add commands resolve the renderer from modern.config. --renderer is only supported for initial generation.');
     const overlays = (0, flags_cjs_namespaceObject.detectCodeSmithOverlays)(args);
     const bridgeRequested = (0, bridge_config_cjs_namespaceObject.hasUltramodernBridgeCliOptions)(args);
     if (dryRun && !verticalInput.addVertical) {
@@ -115,8 +117,8 @@ async function main() {
                 horizontalRemote: true
             } : {}
         };
-        if (dryRun) return void console.log(JSON.stringify((0, external_ultramodern_workspace_index_cjs_namespaceObject.planUltramodernVertical)(verticalOptions), null, 2));
-        (0, external_ultramodern_workspace_index_cjs_namespaceObject.addUltramodernVertical)(verticalOptions);
+        if (dryRun) return void console.log(JSON.stringify(await (0, external_ultramodern_workspace_index_cjs_namespaceObject.planUltramodernVertical)(verticalOptions), null, 2));
+        await (0, external_ultramodern_workspace_index_cjs_namespaceObject.addUltramodernVertical)(verticalOptions);
         const dim = '\x1b[2m\x1b[3m';
         const reset = '\x1b[0m';
         console.log(`${index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.message.success)}\n`);
@@ -139,7 +141,7 @@ async function main() {
     }
     const packageSource = (0, package_source_cjs_namespaceObject.resolveWorkspacePackageSource)(args, createPackage, (0, package_source_cjs_namespaceObject.detectUltramodernPackageSource)(args, ultramodernPackageVersion, createPackage));
     const generateAgentFiles = !args.includes('--no-agents-md');
-    (0, external_ultramodern_workspace_index_cjs_namespaceObject.generateUltramodernWorkspace)({
+    await (0, external_ultramodern_workspace_index_cjs_namespaceObject.generateUltramodernWorkspace)({
         targetDir,
         packageName: generatedPackageName,
         modernVersion: version,
@@ -147,7 +149,10 @@ async function main() {
         bridge,
         overlays,
         packageSource,
-        generateAgentFiles
+        generateAgentFiles,
+        ...renderer ? {
+            renderer
+        } : {}
     });
     const initializedGitRepository = (0, project_setup_cjs_namespaceObject.initializeGeneratedGitRepository)(targetDir);
     const dim = '\x1b[2m\x1b[3m';