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

package/README.md

@@ -12,15 +12,30 @@
 
 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:
+To initialize the empty directory you are already in, pass `.` explicitly:
+
+```bash
+pnpm dlx @bleedingdev/modern-js-create .
+```
+
+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 +60,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 +72,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 +114,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 +205,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

@@ -449,7 +449,7 @@ const EN_LOCALE = {
         createFailed: 'Error creating project:'
     },
     message: {
-        welcome: '🚀 Welcome to Modern.js',
+        welcome: '🚀 Welcome to UltraModern.js',
         success: '✨ Created successfully!',
         nextSteps: '📋 Next steps:',
         step1: 'cd {projectName}',
@@ -457,16 +457,16 @@ const EN_LOCALE = {
         step3: 'pnpm dev'
     },
     help: {
-        title: '🚀 Modern.js Project Creator',
-        description: 'Create a new Modern.js project with ease',
+        title: '🚀 UltraModern.js Project Creator',
+        description: 'Create a new UltraModern.js app with TanStack Router and Effect BFF by default',
         usage: '📖 Usage:',
-        usageExample: '  create [project-name] [options]',
+        usageExample: '  pnpm dlx @bleedingdev/modern-js-create [project-name] [options]',
         options: '⚙️  Options:',
         optionHelp: '  -h, --help     Display this help message',
         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)',
@@ -477,22 +477,22 @@ const EN_LOCALE = {
         optionVertical: '      --vertical Mutate the current existing UltraModern workspace and wire a MicroVertical named <project-name>',
         optionSub: '  -s, --sub       Mark as a subproject (package in monorepo)',
         examples: '💡 Examples:',
-        example1: '  create my-app',
-        example2: '  create my-app --lang zh',
-        example3: '  create my-app --sub',
-        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',
-        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',
+        example1: '  pnpm dlx @bleedingdev/modern-js-create my-app',
+        example2: '  pnpm dlx @bleedingdev/modern-js-create my-app --lang zh',
+        example3: '  pnpm dlx @bleedingdev/modern-js-create my-app --sub',
+        example4: '  pnpm dlx @bleedingdev/modern-js-create --help',
+        example5: '  pnpm dlx @bleedingdev/modern-js-create .',
+        example6: '  pnpm dlx @bleedingdev/modern-js-create my-app --router react-router --no-tailwind',
+        example7: '  pnpm dlx @bleedingdev/modern-js-create my-app --bff-runtime hono',
+        example8: '  pnpm dlx @bleedingdev/modern-js-create my-app --workspace',
+        example9: '  pnpm dlx @bleedingdev/modern-js-create my-super-app --ultramodern-workspace',
+        example10: '  pnpm dlx @bleedingdev/modern-js-create my-app --no-tailwind',
+        example11: '  pnpm dlx @bleedingdev/modern-js-create my-app --router react-router',
+        example12: '  pnpm dlx @bleedingdev/modern-js-create catalog --vertical',
         moreInfo: '📚 Learn more: https://modernjs.dev'
     },
     version: {
-        message: '@modern-js/create version: {version}'
+        message: '@bleedingdev/modern-js-create version: {version}'
     }
 };
 const ZH_LOCALE = {
@@ -507,7 +507,7 @@ const ZH_LOCALE = {
         createFailed: '创建项目时出错:'
     },
     message: {
-        welcome: '🚀 欢迎使用 Modern.js',
+        welcome: '🚀 欢迎使用 UltraModern.js',
         success: '✨ 创建成功！',
         nextSteps: '📋 下一步：',
         step1: 'cd {projectName}',
@@ -515,16 +515,16 @@ const ZH_LOCALE = {
         step3: 'pnpm dev'
     },
     help: {
-        title: '🚀 Modern.js 项目创建工具',
-        description: '快速创建一个新的 Modern.js 项目',
+        title: '🚀 UltraModern.js 项目创建工具',
+        description: '创建默认包含 TanStack Router 和 Effect BFF 的 UltraModern.js 应用',
         usage: '📖 用法:',
-        usageExample: '  create [项目名称] [选项]',
+        usageExample: '  pnpm dlx @bleedingdev/modern-js-create [项目名称] [选项]',
         options: '⚙️  选项:',
         optionHelp: '  -h, --help     显示帮助信息',
         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 联调）',
@@ -535,22 +535,22 @@ const ZH_LOCALE = {
         optionVertical: '      --vertical 修改当前已有的 UltraModern 工作区，并接入名为 <项目名称> 的 MicroVertical',
         optionSub: '  -s, --sub       标记为子项目（monorepo 中的子包）',
         examples: '💡 示例:',
-        example1: '  create my-app',
-        example2: '  create my-app --lang zh',
-        example3: '  create my-app --sub',
-        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',
-        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',
+        example1: '  pnpm dlx @bleedingdev/modern-js-create my-app',
+        example2: '  pnpm dlx @bleedingdev/modern-js-create my-app --lang zh',
+        example3: '  pnpm dlx @bleedingdev/modern-js-create my-app --sub',
+        example4: '  pnpm dlx @bleedingdev/modern-js-create --help',
+        example5: '  pnpm dlx @bleedingdev/modern-js-create .',
+        example6: '  pnpm dlx @bleedingdev/modern-js-create my-app --router react-router --no-tailwind',
+        example7: '  pnpm dlx @bleedingdev/modern-js-create my-app --bff-runtime hono',
+        example8: '  pnpm dlx @bleedingdev/modern-js-create my-app --workspace',
+        example9: '  pnpm dlx @bleedingdev/modern-js-create my-super-app --ultramodern-workspace',
+        example10: '  pnpm dlx @bleedingdev/modern-js-create my-app --no-tailwind',
+        example11: '  pnpm dlx @bleedingdev/modern-js-create my-app --router react-router',
+        example12: '  pnpm dlx @bleedingdev/modern-js-create catalog --vertical',
         moreInfo: '📚 更多信息: https://modernjs.dev'
     },
     version: {
-        message: '@modern-js/create 版本: {version}'
+        message: '@bleedingdev/modern-js-create 版本: {version}'
     }
 };
 const i18n = new I18n();
@@ -921,6 +921,7 @@ function appDependencies(scope, packageSource, app, remotes = []) {
         '@modern-js/plugin-tanstack': modernPackageSpecifier('@modern-js/plugin-tanstack', packageSource),
         '@modern-js/plugin-i18n': modernPackageSpecifier('@modern-js/plugin-i18n', packageSource),
         '@modern-js/runtime': modernPackageSpecifier('@modern-js/runtime', packageSource),
+        '@module-federation/bridge-react': MODULE_FEDERATION_VERSION,
         '@module-federation/modern-js-v3': MODULE_FEDERATION_VERSION,
         '@module-federation/runtime': MODULE_FEDERATION_VERSION,
         '@tanstack/react-router': TANSTACK_ROUTER_VERSION,
@@ -2371,7 +2372,7 @@ function createShellRemoteComponents(scope, remotes = []) {
         return `          <${componentName} key="${remote.id}" />`;
     }).join('\n');
     const remoteCount = String(widgetRemotes.length);
-    return `import { createLazyComponent } from '@module-federation/modern-js-v3/react';
+    return `import { createLazyComponent } from '@module-federation/bridge-react';
 import { getInstance, loadRemote } from '@module-federation/modern-js-v3/runtime';
 import { Suspense, useEffect, useMemo, useState } from 'react';
 import type { ComponentType } from 'react';
@@ -2482,7 +2483,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 +2492,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 +2529,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>
@@ -2821,7 +2821,7 @@ export default function ${componentName}() {
 }
 function createRecordsRemoteComponents(scope, app) {
     const tw = createTw(tailwindPrefixForApp(app));
-    return `import { createLazyComponent } from '@module-federation/modern-js-v3/react';
+    return `import { createLazyComponent } from '@module-federation/bridge-react';
 import { getInstance, loadRemote } from '@module-federation/modern-js-v3/runtime';
 import { Suspense, useEffect, useMemo, useState } from 'react';
 import type { ComponentType } from 'react';
@@ -5752,7 +5752,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
@@ -6279,10 +6279,16 @@ async function getProjectName() {
         process.exit(1);
     }
     const projectNameArg = positionalArgs[0];
-    if (projectNameArg) return {
-        name: projectNameArg,
-        useCurrentDir: false
-    };
+    if (projectNameArg) {
+        if ('.' === projectNameArg) return {
+            name: node_path.basename(process.cwd()),
+            useCurrentDir: true
+        };
+        return {
+            name: projectNameArg,
+            useCurrentDir: false
+        };
+    }
     const currentDir = process.cwd();
     if (isDirectoryEmpty(currentDir)) return {
         name: node_path.basename(currentDir),

package/package.json

@@ -21,7 +21,7 @@
   "engines": {
     "node": ">=20"
   },
-  "version": "3.2.0-ultramodern.74",
+  "version": "3.2.0-ultramodern.77",
   "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.77"
   },
   "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.77"
   }
 }

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,