@bleedingdev/modern-js-create 3.2.0-ultramodern.4 → 3.2.0-ultramodern.5

package/README.md

@@ -12,6 +12,13 @@
 
 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 SuperApp workspace and published BleedingDev package aliases:
+
+```bash
+pnpm dlx @bleedingdev/modern-js-create my-super-app
+```
+
 ### Router Template
 
 You can scaffold a TanStack Router first template:
@@ -89,6 +96,11 @@ 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.
+
 ### Local Monorepo Testing
 
 When testing unreleased Modern.js packages from a local monorepo checkout, use

package/dist/index.js

@@ -485,7 +485,7 @@ const EN_LOCALE = {
         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: '  create my-super-app --ultramodern-workspace --ultramodern-package-source install --ultramodern-package-scope bleedingdev',
+        example10: '  pnpm dlx @bleedingdev/modern-js-create my-super-app',
         moreInfo: '📚 Learn more: https://modernjs.dev'
     },
     version: {
@@ -2008,9 +2008,15 @@ function writeTemplateManifestEvidence(targetDir, manifest) {
     });
     node_fs.writeFileSync(evidencePath, `${JSON.stringify(manifest, null, 2)}\n`);
 }
-function showVersion() {
+function readCreatePackageJson() {
     const createPackageJson = node_path.resolve(src_dirname, '..', 'package.json');
-    const createPackage = JSON.parse(node_fs.readFileSync(createPackageJson, 'utf-8'));
+    return JSON.parse(node_fs.readFileSync(createPackageJson, 'utf-8'));
+}
+function isBleedingDevCreatePackage(createPackage) {
+    return '@bleedingdev/modern-js-create' === createPackage.name;
+}
+function showVersion() {
+    const createPackage = readCreatePackageJson();
     const version = createPackage.version || 'unknown';
     console.log(i18n.t(localeKeys.version.message, {
         version
@@ -2081,14 +2087,15 @@ function detectWorkspaceProtocolFlag() {
     const args = process.argv.slice(2);
     return args.includes('--workspace');
 }
-function detectUltramodernWorkspaceFlag() {
+function detectUltramodernWorkspaceFlag(createPackage) {
     const args = process.argv.slice(2);
-    return args.includes(ULTRAMODERN_WORKSPACE_FLAG);
+    return args.includes(ULTRAMODERN_WORKSPACE_FLAG) || isBleedingDevCreatePackage(createPackage);
 }
-function detectUltramodernPackageSource(args, modernVersion) {
+function detectUltramodernPackageSource(args, modernVersion, createPackage) {
+    const bleedingDevDefaults = isBleedingDevCreatePackage(createPackage);
     const strategy = getOptionValue(args, [
         '--ultramodern-package-source'
-    ]) ?? 'workspace';
+    ]) ?? (bleedingDevDefaults ? 'install' : 'workspace');
     if ('workspace' !== strategy && 'install' !== strategy) {
         console.error('--ultramodern-package-source must be "workspace" or "install"');
         process.exit(1);
@@ -2103,7 +2110,7 @@ function detectUltramodernPackageSource(args, modernVersion) {
         ]),
         aliasScope: getOptionValue(args, [
             '--ultramodern-package-scope'
-        ]),
+        ]) ?? (bleedingDevDefaults && 'install' === strategy ? 'bleedingdev' : void 0),
         aliasPackageNamePrefix: getOptionValue(args, [
             '--ultramodern-package-name-prefix'
         ]) ?? 'modern-js-'
@@ -2194,16 +2201,15 @@ async function main() {
             process.exit(1);
         }
     }
-    const createPackageJson = node_path.resolve(src_dirname, '..', 'package.json');
-    const createPackage = JSON.parse(node_fs.readFileSync(createPackageJson, 'utf-8'));
+    const createPackage = readCreatePackageJson();
     const version = createPackage.version || 'latest';
-    const generateWorkspace = detectUltramodernWorkspaceFlag();
+    const generateWorkspace = detectUltramodernWorkspaceFlag(createPackage);
     if (generateWorkspace) {
         generateUltramodernWorkspace({
             targetDir,
             packageName: generatedPackageName,
             modernVersion: version,
-            packageSource: detectUltramodernPackageSource(args, version)
+            packageSource: detectUltramodernPackageSource(args, version, createPackage)
         });
         const dim = '\x1b[2m\x1b[3m';
         const reset = '\x1b[0m';

package/package.json

@@ -21,7 +21,7 @@
   "engines": {
     "node": ">=20"
   },
-  "version": "3.2.0-ultramodern.4",
+  "version": "3.2.0-ultramodern.5",
   "types": "./dist/types/index.d.ts",
   "main": "./dist/index.js",
   "bin": {
@@ -41,7 +41,7 @@
     "@types/node": "^25.8.0",
     "@typescript/native-preview": "7.0.0-dev.20260516.1",
     "tsx": "^4.22.0",
-    "@modern-js/i18n-utils": "npm:@bleedingdev/modern-js-i18n-utils@3.2.0-ultramodern.4"
+    "@modern-js/i18n-utils": "npm:@bleedingdev/modern-js-i18n-utils@3.2.0-ultramodern.5"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",