@bleedingdev/modern-js-create 3.2.0-ultramodern.73 → 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>
@@ -4507,9 +4506,8 @@ function createWorkspaceI18nBoundaryValidationScript() {
     return `#!/usr/bin/env node
 import fs from 'node:fs';
 import path from 'node:path';
-import { fileURLToPath } from 'node:url';
 
-const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const root = path.resolve(import.meta.dirname, '..');
 const sourceRoots = ['apps', 'verticals'];
 const languageConditionalPattern =
   /\\b(language|locale|lng|currentLanguage)\\s*={0,2}={1,2}\\s*['"][a-z-]+['"]\\s*\\?\\s*([^:;\\n]+)\\s*:\\s*([^;\\n})]+)/gu;
@@ -4529,11 +4527,11 @@ const visibleCopyAttributes = new Set([
   'title',
 ]);
 
-function fail(message) {
+const fail = (message) => {
   throw new Error(message);
-}
+};
 
-function walk(directory, files = []) {
+const walk = (directory, files = []) => {
   if (!fs.existsSync(directory)) {
     return files;
   }
@@ -4549,43 +4547,37 @@ function walk(directory, files = []) {
     }
   }
   return files;
-}
+};
 
-function relative(filePath) {
-  return path.relative(root, filePath).replace(/\\\\/gu, '/');
-}
+const relative = (filePath) => path.relative(root, filePath).replaceAll('\\\\', '/');
 
-function isSourceFile(filePath) {
-  return /\\.(?:ts|tsx|js|jsx)$/u.test(filePath);
-}
+const isSourceFile = (filePath) => /\\.(?:ts|tsx|js|jsx)$/u.test(filePath);
 
-function isLocaleJson(filePath) {
+const isLocaleJson = (filePath) => {
   const normalized = relative(filePath);
   return /\\/locales\\/(en|cs)\\/[^/]+\\.json$/u.test(normalized);
-}
+};
 
-function readText(filePath) {
-  return fs.readFileSync(filePath, 'utf8');
-}
+const readText = (filePath) => fs.readFileSync(filePath, 'utf-8');
 
-function branchIsUserCopy(branch) {
+const branchIsUserCopy = (branch) => {
   const value = branch.trim().replace(/,$/u, '');
   if (allowedLanguageConditionalBranches.has(value)) {
     return false;
   }
   return /^['"][^'"]{2,}['"]$/u.test(value);
-}
+};
 
-function checkRuntimeResources(filePath, text) {
+const checkRuntimeResources = (filePath, text) => {
   if (!relative(filePath).endsWith('/src/modern.runtime.ts')) {
     return;
   }
   if (/initOptions\\s*:\\s*\\{[\\s\\S]*?\\bresources\\s*:/u.test(text)) {
     fail(\`\${relative(filePath)} must not inline i18n resources in modern.runtime.ts; use locale JSON files.\`);
   }
-}
+};
 
-function checkLanguageConditionals(filePath, text) {
+const checkLanguageConditionals = (filePath, text) => {
   for (const match of text.matchAll(languageConditionalPattern)) {
     const [, name, whenTrue = '', whenFalse = ''] = match;
     if (branchIsUserCopy(whenTrue) || branchIsUserCopy(whenFalse)) {
@@ -4594,9 +4586,9 @@ function checkLanguageConditionals(filePath, text) {
       );
     }
   }
-}
+};
 
-function checkLiteralVisibleAttributes(filePath, text) {
+const checkLiteralVisibleAttributes = (filePath, text) => {
   if (!filePath.endsWith('.tsx') && !filePath.endsWith('.jsx')) {
     return;
   }
@@ -4608,17 +4600,17 @@ function checkLiteralVisibleAttributes(filePath, text) {
       );
     }
   }
-}
+};
 
-function checkSplitPhraseKeys(filePath, text) {
+const checkSplitPhraseKeys = (filePath, text) => {
   if (/t\\(\\s*['"][^'"]+\\.(?:prefix|suffix|before|after)['"]\\s*\\)/u.test(text)) {
     fail(
       \`\${relative(filePath)} uses split phrase translation keys. Keep translator-owned phrases whole.\`,
     );
   }
-}
+};
 
-function checkBoundaryAttributes(filePath, text) {
+const checkBoundaryAttributes = (filePath, text) => {
   if (!filePath.endsWith('.tsx') && !filePath.endsWith('.jsx')) {
     return;
   }
@@ -4627,9 +4619,9 @@ function checkBoundaryAttributes(filePath, text) {
       \`\${relative(filePath)} uses legacy data-mf-* boundary attributes. Use data-modern-boundary-id and data-modern-mf-expose.\`,
     );
   }
-}
+};
 
-function visitLocaleKeys(value, visitor, pathParts = []) {
+const visitLocaleKeys = (value, visitor, pathParts = []) => {
   if (!value || typeof value !== 'object' || Array.isArray(value)) {
     return;
   }
@@ -4638,9 +4630,9 @@ function visitLocaleKeys(value, visitor, pathParts = []) {
     visitor(key, child, nextPath);
     visitLocaleKeys(child, visitor, nextPath);
   }
-}
+};
 
-function checkPluralResources(filePath, json) {
+const checkPluralResources = (filePath, json) => {
   const language = relative(filePath).split('/locales/')[1]?.split('/')[0];
   const requiredSuffixes =
     language === 'cs' ? ['one', 'few', 'many', 'other'] : ['one', 'other'];
@@ -4670,7 +4662,7 @@ function checkPluralResources(filePath, json) {
       }
     }
   }
-}
+};
 
 const sourceFiles = sourceRoots.flatMap(sourceRoot =>
   walk(path.join(root, sourceRoot)).filter(filePath => isSourceFile(filePath)),
@@ -5759,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.73",
+  "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.73"
+    "@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.73"
+    "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,