@bleedingdev/modern-js-create 3.2.0-ultramodern.74 → 3.2.0-ultramodern.76

package/README.md

@@ -12,15 +12,24 @@
 
 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 the
-canonical Tractor SuperApp workspace and published BleedingDev package aliases:
+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:
 
 ```bash
-pnpm dlx @bleedingdev/modern-js-create my-super-app
+pnpm dlx @bleedingdev/modern-js-create my-app
 ```
 
-The default workspace is a full-stack reference, not a visual-only commerce
-boundary demo. It generates:
+Create a full SuperApp workspace only when you need independently owned
+verticals:
+
+```bash
+pnpm dlx @bleedingdev/modern-js-create my-super-app --ultramodern-workspace
+```
+
+The workspace is a full-stack reference, not a visual-only commerce boundary
+demo. It generates:
 
 - `apps/shell-super-app` as the Module Federation host and topology owner.
 - `verticals/explore` for discovery UI plus
@@ -45,10 +54,10 @@ pnpm build
 
 ### Router Template
 
-You can scaffold a TanStack Router first template:
+TanStack Router is generated by default. To force the compatibility router:
 
 ```bash
-npx @modern-js/create my-app --router tanstack
+pnpm dlx @bleedingdev/modern-js-create my-app --router react-router
 ```
 
 ### Tailwind Template
@@ -57,43 +66,38 @@ Tailwind CSS v4 setup is generated by default. Disable it explicitly when you
 need a plain CSS starter:
 
 ```bash
-npx @modern-js/create my-app --no-tailwind
+pnpm dlx @bleedingdev/modern-js-create my-app --no-tailwind
 ```
 
 TanStack Router and Tailwind CSS work together without extra flags:
 
 ```bash
-npx @modern-js/create my-app --router tanstack
+pnpm dlx @bleedingdev/modern-js-create my-app
 ```
 
 ### BFF Runtime Template
 
-You can scaffold BFF APIs with the current default runtime:
-
-```bash
-npx @modern-js/create my-app --bff
-```
-
-You can explicitly scaffold Effect HttpApi runtime for BFF:
+UltraModern app scaffolds include Effect HttpApi BFF by default:
 
 ```bash
-npx @modern-js/create my-app --bff-runtime effect
+pnpm dlx @bleedingdev/modern-js-create my-app
 ```
 
 To scaffold Hono runtime explicitly:
 
 ```bash
-npx @modern-js/create my-app --bff-runtime hono
+pnpm dlx @bleedingdev/modern-js-create my-app --bff-runtime hono
 ```
 
 Generated starters expose `presetUltramodern(...)` as the public opinionated
 config wrapper when you want the full Ultramodern setup surface in
 `modern.config.ts`.
 
-You can combine TanStack Router + default Tailwind + Effect BFF in one command:
+TanStack Router, default Tailwind, and Effect BFF are included without extra
+flags. For local monorepo dependency testing, add `--workspace`:
 
 ```bash
-npx @modern-js/create my-app --router tanstack --bff-runtime effect
+pnpm dlx @bleedingdev/modern-js-create my-app --workspace
 ```
 
 ### Vertical Workspace Recipes
@@ -104,7 +108,7 @@ overlay, ownership entry, Effect BFF surface, and root `dev:*` script from the
 requested vertical name.
 
 ```bash
-npx @modern-js/create catalog --vertical
+pnpm dlx @bleedingdev/modern-js-create catalog --vertical
 ```
 
 Use this decision table before adding a vertical:
@@ -195,14 +199,14 @@ When testing unreleased Modern.js packages from a local monorepo checkout, use
 workspace protocol dependencies:
 
 ```bash
-npx @modern-js/create my-app --router tanstack --bff-runtime effect --workspace
+pnpm dlx @bleedingdev/modern-js-create my-app --workspace
 ```
 
 For package-source validation of the full Tractor workspace, generate with the
 workspace package source, then run the generated contract gate:
 
 ```bash
-npx @modern-js/create tractor-super-app --workspace
+pnpm dlx @bleedingdev/modern-js-create tractor-super-app --ultramodern-workspace --ultramodern-package-source workspace
 cd tractor-super-app
 pnpm install
 pnpm ultramodern:check

package/dist/index.js

@@ -466,7 +466,7 @@ const EN_LOCALE = {
         optionVersion: '  -v, --version  Display version information',
         optionLang: '  -l, --lang     Set the language (zh or en)',
         optionRouter: '  -r, --router   Select router framework (react-router or tanstack)',
-        optionBff: '      --bff      Enable BFF scaffold (default runtime: effect)',
+        optionBff: '      --bff      Keep Effect BFF enabled (default for UltraModern apps)',
         optionBffRuntime: '      --bff-runtime Select BFF runtime (hono or effect)',
         optionTailwind: '      --no-tailwind Disable default Tailwind CSS v4 scaffold',
         optionWorkspace: '      --workspace Use workspace protocol for @modern-js dependencies (for local monorepo testing)',
@@ -483,9 +483,9 @@ const EN_LOCALE = {
         example4: '  create --help',
         example5: '  create my-app --router tanstack',
         example6: '  create my-app --router tanstack --no-tailwind',
-        example7: '  create my-app --bff',
-        example8: '  create my-app --router tanstack --bff-runtime effect',
-        example9: '  create my-app --router tanstack --bff-runtime effect --workspace',
+        example7: '  create my-app --bff-runtime hono',
+        example8: '  create my-app --workspace',
+        example9: '  create my-app --bff-runtime effect --workspace',
         example10: '  pnpm dlx @bleedingdev/modern-js-create my-app',
         example11: '  pnpm dlx @bleedingdev/modern-js-create my-super-app --ultramodern-workspace',
         example12: '  create catalog --vertical',
@@ -524,7 +524,7 @@ const ZH_LOCALE = {
         optionVersion: '  -v, --version  显示版本信息',
         optionLang: '  -l, --lang     设置语言 (zh 或 en)',
         optionRouter: '  -r, --router   选择路由框架 (react-router 或 tanstack)',
-        optionBff: '      --bff      启用 BFF 模板（默认运行时：effect）',
+        optionBff: '      --bff      保持启用 Effect BFF（UltraModern 应用默认值）',
         optionBffRuntime: '      --bff-runtime 选择 BFF 运行时（hono 或 effect）',
         optionTailwind: '      --no-tailwind 禁用默认 Tailwind CSS v4 模板',
         optionWorkspace: '      --workspace 对 @modern-js 依赖使用 workspace 协议（用于本地 monorepo 联调）',
@@ -541,9 +541,9 @@ const ZH_LOCALE = {
         example4: '  create --help',
         example5: '  create my-app --router tanstack',
         example6: '  create my-app --router tanstack --no-tailwind',
-        example7: '  create my-app --bff',
-        example8: '  create my-app --router tanstack --bff-runtime effect',
-        example9: '  create my-app --router tanstack --bff-runtime effect --workspace',
+        example7: '  create my-app --bff-runtime hono',
+        example8: '  create my-app --workspace',
+        example9: '  create my-app --bff-runtime effect --workspace',
         example10: '  pnpm dlx @bleedingdev/modern-js-create my-app',
         example11: '  pnpm dlx @bleedingdev/modern-js-create my-super-app --ultramodern-workspace',
         example12: '  create catalog --vertical',
@@ -2482,7 +2482,7 @@ function createRemotePage(app) {
     const listEffectItems = `list${toPascalCase(effectApiStem(app))}`;
     const effectBffImport = appHasEffectApi(app) ? `import { useModernI18n } from '@modern-js/plugin-i18n/runtime';
 import { Helmet } from '@modern-js/runtime/head';
-import { useLocation } from '@modern-js/plugin-tanstack/runtime';
+import { Link, useLocation } from '@modern-js/plugin-tanstack/runtime';
 import { useEffect, useState } from 'react';
 import {
   Effect,
@@ -2491,7 +2491,7 @@ import {
 } from '../../effect/${effectApiStem(app)}-client';
 import { ultramodernLocalisedUrls } from '../ultramodern-route-metadata';
 import { ultramodernUiMarker } from '../../ultramodern-build';
-` : "import { useModernI18n } from '@modern-js/plugin-i18n/runtime';\nimport { Helmet } from '@modern-js/runtime/head';\nimport { useLocation } from '@modern-js/plugin-tanstack/runtime';\nimport { ultramodernLocalisedUrls } from '../ultramodern-route-metadata';\nimport { ultramodernUiMarker } from '../../ultramodern-build';\n";
+` : "import { useModernI18n } from '@modern-js/plugin-i18n/runtime';\nimport { Helmet } from '@modern-js/runtime/head';\nimport { Link, useLocation } from '@modern-js/plugin-tanstack/runtime';\nimport { ultramodernLocalisedUrls } from '../ultramodern-route-metadata';\nimport { ultramodernUiMarker } from '../../ultramodern-build';\n";
     const effectBffState = appHasEffectApi(app) ? `  const [effectApiStatus, setEffectApiStatus] = useState('pending');
 
   useEffect(() => {
@@ -2528,21 +2528,20 @@ ${createLocalizedHeadComponent()}
 export default function ${toPascalCase(app.id)}Home() {
   const { i18nInstance, language } = useModernI18n();
   const t = i18nInstance['t'].bind(i18nInstance);
-  const location = useLocation();
-  const suffix = locationSuffix(location);
 ${effectBffState}  return (
     <main className="${tw('min-h-screen bg-um-canvas px-4 py-6 text-um-foreground sm:px-8')}">
       <LocalizedHead />
       <nav aria-label={t('${app.domain}.language.switcher')} className="${tw('flex gap-3')}">
         {supportedLanguages.map(code => (
-          <a
+          <Link
             aria-current={language === code ? 'page' : undefined}
             className="${tw('rounded-full border border-stone-900/15 bg-white px-4 py-2 text-sm font-bold text-stone-950 no-underline')}"
-            href={\`\${localizedPath(location.pathname, code)}\${suffix}\`}
             key={code}
+            params={{ lang: code }}
+            to="/$lang"
           >
             {t(\`${app.domain}.language.\${code}\`)}
-          </a>
+          </Link>
         ))}
       </nav>
       <h1 className="${tw('mt-10 text-5xl font-black')}">{t('${app.domain}.title')}</h1>
@@ -5752,7 +5751,7 @@ function detectBffRuntime() {
     const runtimeValue = getOptionValue(args, [
         '--bff-runtime'
     ]);
-    if (!runtimeValue) return args.includes('--bff') ? 'effect' : 'none';
+    if (!runtimeValue) return 'effect';
     if ('hono' === runtimeValue || 'effect' === runtimeValue) return runtimeValue;
     console.error(i18n.t(localeKeys.error.invalidBffRuntime, {
         runtime: runtimeValue

package/package.json

@@ -21,7 +21,7 @@
   "engines": {
     "node": ">=20"
   },
-  "version": "3.2.0-ultramodern.74",
+  "version": "3.2.0-ultramodern.76",
   "types": "./dist/types/index.d.ts",
   "main": "./dist/index.js",
   "bin": {
@@ -41,7 +41,7 @@
     "@types/node": "^25.9.1",
     "@typescript/native-preview": "7.0.0-dev.20260527.2",
     "tsx": "^4.22.3",
-    "@modern-js/i18n-utils": "npm:@bleedingdev/modern-js-i18n-utils@3.2.0-ultramodern.74"
+    "@modern-js/i18n-utils": "npm:@bleedingdev/modern-js-i18n-utils@3.2.0-ultramodern.76"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
@@ -54,6 +54,6 @@
     "start": "node ./dist/index.js"
   },
   "ultramodern": {
-    "frameworkVersion": "3.2.0-ultramodern.74"
+    "frameworkVersion": "3.2.0-ultramodern.76"
   }
 }

package/template-workspace/README.md.handlebars

@@ -14,8 +14,8 @@ UltraModern.js 3.0 SuperApp surface and starts with an explicit shell:
 Add a full-stack MicroVertical when the product needs one:
 
 ```bash
-pnpm create modern@latest transportation --vertical
-pnpm create modern@latest payments --vertical
+pnpm dlx @bleedingdev/modern-js-create transportation --vertical
+pnpm dlx @bleedingdev/modern-js-create payments --vertical
 ```
 
 Each added vertical owns its UI/routes, browser-safe Module Federation exposes,