@multisystemsuite/create-mf-app 1.0.14 → 1.0.16

package/README.md

@@ -303,9 +303,25 @@ npx create-mf-app <project-name> [options]
 | `--federation=true\|false` | Module Federation (default: `true`) |
 | `--control-plane` | Workflow Designer & Monitoring preset (6 apps + corelib, control-plane API, mf-* packages) |
 | `--federation-os` | Full Enterprise Federation OS preset (10 apps + corelib, runtime, observability stack) |
+| `--lite` | **Faster install** — skip ESLint/Vitest/Husky stack and optional SDK packages |
 | `-y`, `--yes` | Non-interactive (use defaults where applicable) |
 | `-h`, `--help` | Show help |
 
+**Faster install (`--lite`):**
+
+```bash
+npx create-mf-app my-platform --type=parent --children=billing,orders --shared=corelib --lite -y
+```
+
+Skips ESLint, Prettier, Stylelint, Vitest, Husky, commitlint, and optional SDK packages (`api-client`, `sdk-core`, `websocket-sdk`). Federation, apps, `corelib`, and `query-client` are still included — typical install drops from ~850 to ~400 packages.
+
+**Other ways to speed up install:**
+
+- Exclude the project folder from Windows Defender real-time scan
+- Second `npm install` is much faster (npm cache)
+- Use `HUSKY=0 npm install` to skip git hooks on any scaffold
+- Fewer `--children` = fewer apps = less to resolve
+
 ### Add a child to an existing parent workspace
 
 ```bash
@@ -1431,6 +1447,8 @@ Node 18 will fail on Vite 7 commands.
 | `Cannot find module 'billing/App'` | Add federation `.d.ts` declarations in host |
 | `Task not found: live-reload` | Root `"live-reload": "node live-reload.js"` |
 | Vite binary missing after install | Clean reinstall (see below) |
+| **`npm install` very slow (~2 min+)** | Use `--lite` for faster scaffold; exclude project from antivirus scan; second install uses npm cache |
+| **`npm run local` fails on `api-client` build** | Update to latest CLI (smart-build skips source-only packages) or patch `smart-build.js` |
 | Sidebar overlaps main content | Use generated flex sidebar in corelib |
 | **Text invisible on dark header/sidebar** | Clear `localStorage` key `mf-enterprise-config`; hard refresh |
 | `provider support react(undefined)` / `useState` null | Rebuild all apps after federation config change; host uses exact `version: "19.0.0"`, remotes use `requiredVersion: "^19.0.0"` |

package/dist/index.js

@@ -365,6 +365,17 @@ function writeCache(projectId, hash) {
   fs.writeFileSync(cachePath(projectId), JSON.stringify({ hash, mode, at: Date.now() }, null, 2));
 }
 
+function hasBuildScript(projectRoot) {
+  const pkgPath = path.join(projectRoot, "package.json");
+  if (!fs.existsSync(pkgPath)) return false;
+  try {
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+    return typeof pkg.scripts?.build === "string" && pkg.scripts.build.trim().length > 0;
+  } catch {
+    return false;
+  }
+}
+
 function runBuild(projectId, root) {
   return new Promise((resolve) => {
     const npm = process.platform === "win32" ? "npm.cmd" : "npm";
@@ -392,6 +403,12 @@ async function main() {
   let order = topoSort(graph, onlyProjects);
   if (!order.length) order = Object.keys(config.projects ?? {});
 
+  order = order.filter((projectId) => {
+    const meta = config.projects[projectId];
+    if (!meta?.root) return false;
+    return hasBuildScript(path.join(cwd, meta.root));
+  });
+
   console.log("[smart-build] mode=" + mode + " projects=" + order.join(", "));
 
   const waves = [];
@@ -414,6 +431,10 @@ async function main() {
         const meta = config.projects[projectId];
         if (!meta?.root) return;
         const projectRoot = path.join(cwd, meta.root);
+        if (!hasBuildScript(projectRoot)) {
+          console.log("[skip] " + projectId + " (no build script \u2014 source-only workspace package)");
+          return;
+        }
         const hash = hashProject(projectRoot);
         if (skipUnchanged) {
           const cached = readCache(projectId);
@@ -3521,28 +3542,12 @@ function mergeAppTsconfigForQuality(existing) {
 `;
 }
 var APP_QUALITY_DEV_DEPS = {
-  vitest: "^3.0.5",
-  "@vitest/coverage-v8": "^3.0.5",
-  jsdom: "^25.0.1",
-  "@testing-library/react": "^16.2.0",
-  "@testing-library/jest-dom": "^6.6.3",
-  "@testing-library/user-event": "^14.5.2",
   "cross-env": "^7.0.3",
   "rollup-plugin-visualizer": "^5.14.0",
   "vite-plugin-compression": "^0.5.1"
 };
 var APP_QUALITY_SCRIPTS = {
-  lint: "eslint src --ext .ts,.tsx --max-warnings 0",
-  "lint:fix": "eslint src --ext .ts,.tsx --fix",
-  format: 'prettier --write "src/**/*.{ts,tsx,css,json}"',
-  "format:check": 'prettier --check "src/**/*.{ts,tsx,css,json}"',
   "type-check": "tsc --noEmit -p tsconfig.json",
-  test: "vitest",
-  "test:ci": "vitest run",
-  coverage: "vitest run --coverage",
-  cleanup: "npm run lint:fix && npm run cleanup:imports && npm run type-check",
-  "cleanup:imports": "npm run lint:fix",
-  "cleanup:deadcode": "node ../../scripts/deadcode-scan-placeholder.js",
   "build:prod": "tsc -b && vite build --mode prod",
   analyze: "cross-env VITE_ANALYZE=1 tsc -b && vite build --mode prod"
 };
@@ -7931,7 +7936,7 @@ export function clearQueryCache(client: QueryClient): void {
   client.clear();
 }
 `;
-  const providerBody = `import type { ReactNode } from "react";
+  const providerBody = `import React, { type ReactNode } from "react";
 import { QueryClientProvider } from "@tanstack/react-query";
 import { createAppQueryClient } from "./index";
 
@@ -7946,6 +7951,23 @@ export { queryClient };
   return {
     ...pkg(scope, "query-client", "./src/index.ts", { "@tanstack/react-query": "^5.66.9" }, indexBody),
     [`packages/query-client/src/QueryProvider.tsx`]: providerBody,
+    [`packages/query-client/tsconfig.json`]: `${JSON.stringify(
+      {
+        compilerOptions: {
+          target: "ES2022",
+          module: "ESNext",
+          moduleResolution: "Bundler",
+          jsx: "react-jsx",
+          strict: true,
+          skipLibCheck: true,
+          noEmit: true
+        },
+        include: ["src"]
+      },
+      null,
+      2
+    )}
+`,
     [`packages/query-client/package.json`]: `${JSON.stringify(
       {
         name: `@${scope}/query-client`,
@@ -14250,16 +14272,35 @@ export function invalidateCache(cwd) {
   if (fs.existsSync(dir)) fs.rmSync(dir, { recursive: true, force: true });
 }
 `;
-var ORCHESTRATOR = `import { spawn } from "node:child_process";
+var ORCHESTRATOR = `import fs from "node:fs";
+import path from "node:path";
+import { spawn } from "node:child_process";
 import { readCache, writeCache, hashInputs } from "./cache-engine.js";
 import { loadMfConfig } from "../tools/project-graph/graph-engine.js";
 
+function hasWorkspaceScript(projectRoot, script) {
+  const pkgPath = path.join(projectRoot, "package.json");
+  if (!fs.existsSync(pkgPath)) return false;
+  try {
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+    return typeof pkg.scripts?.[script] === "string" && pkg.scripts[script].trim().length > 0;
+  } catch {
+    return false;
+  }
+}
+
 export async function runTarget(projectId, target, options = {}) {
   const cwd = options.cwd ?? process.cwd();
   const config = loadMfConfig(cwd);
   const project = config.projects?.[projectId];
   if (!project) throw new Error("Unknown project: " + projectId);
 
+  const projectRoot = path.join(cwd, project.root);
+  if (!hasWorkspaceScript(projectRoot, target)) {
+    console.log("[skip] " + projectId + ":" + target + " (no script in " + project.root + ")");
+    return { success: true, code: 0, projectId, target, skipped: true };
+  }
+
   const cacheKey = hashInputs({ projectId, target, root: project.root });
   if (options.cache !== false && config.cache?.enabled !== false) {
     const cached = readCache(projectId + ":" + target + ":" + cacheKey, cwd);
@@ -14838,24 +14879,25 @@ export * from "./branding.js";
 
 // src/generators/platformFramework/index.ts
 init_developerExperience();
-function getPlatformFrameworkFiles(projectName, allApps, sharedApp, npmScope) {
+function getPlatformFrameworkFiles(projectName, allApps, sharedApp, npmScope, options) {
+  const lite = options?.lite ?? false;
   return {
     "mf.json": getMfJson(projectName, allApps, sharedApp),
     ...getMfCliFiles(),
     ...getProjectGraphFiles(),
     ...getTaskRunnerFiles(),
     ...getPlatformPluginFiles(),
-    ...getDevtoolsFiles(),
-    ...getCicdAndGovernanceFiles(projectName),
-    ...getTemplateMarketplaceFiles(),
-    ...getAiPlatformFiles(),
-    ...getExtendedSharedPackages(npmScope),
+    ...lite ? {} : getDevtoolsFiles(),
+    ...lite ? {} : getCicdAndGovernanceFiles(projectName),
+    ...lite ? {} : getTemplateMarketplaceFiles(),
+    ...lite ? {} : getAiPlatformFiles(),
+    ...lite ? {} : getExtendedSharedPackages(npmScope),
     ...getRuntimeConfigFiles(),
     ...getArchitectureProtectionFiles(projectName, sharedApp, npmScope),
     ...getDeveloperExperiencePlatformFiles(projectName, allApps),
     "tools/mf-cli/schemas/mf.schema.json": getMfSchema(),
     "docs/PLATFORM_ARCHITECTURE.md": getPlatformArchitectureDoc(projectName),
-    ".vscode/mf.code-snippets": VSCODE_SNIPPETS
+    ...lite ? {} : { ".vscode/mf.code-snippets": VSCODE_SNIPPETS }
   };
 }
 var VSCODE_SNIPPETS = `{
@@ -15154,6 +15196,7 @@ function buildConfigFromArgs(argv) {
   }
   const federationOs = toBoolean(options["federation-os"] ?? options.federationOs, false);
   const controlPlane = toBoolean(options["control-plane"] ?? options.controlPlane, false);
+  const lite = toBoolean(options.lite, false);
   let config = {
     projectName: resolvedProjectName,
     port,
@@ -15165,7 +15208,8 @@ function buildConfigFromArgs(argv) {
     shared: resolveShared(options),
     features: resolveEnterpriseFeatures(options),
     federationOs,
-    controlPlane
+    controlPlane,
+    lite
   };
   if (controlPlane) {
     config = applyControlPlanePreset(config);
@@ -19787,6 +19831,13 @@ export function buildFederation() {
 // src/generators/project.ts
 var FEDERATION_SHARED_IMPORT = "../../../../packages/shared-config/src/federationShared.js";
 var FEDERATION_REMOTES_IMPORT = "../../../../packages/shared-config/src/federationRemotes.js";
+function getNpmrcContent() {
+  return `install-strategy=hoisted
+fund=false
+audit=false
+prefer-offline=true
+`;
+}
 function getDockerfile(port) {
   return `FROM node:22-alpine
 
@@ -19896,13 +19947,11 @@ async function generateParentWorkspace(projectRoot, config) {
       Object.entries(getWorkspacePackageFiles(npmScope)).map(([filePath, content]) => writeFile(projectRoot, filePath, content))
     );
     if (isEnterpriseParent) {
-      const sdkIds = ["sdk-core", "api-client", "query-client", "websocket-sdk", ...enterpriseFlags.auth ? ["auth-sdk"] : []];
+      const sdkIds = config.lite ? ["query-client"] : ["sdk-core", "api-client", "query-client", "websocket-sdk", ...enterpriseFlags.auth ? ["auth-sdk"] : []];
       await Promise.all(sdkIds.map((pkg2) => import_fs_extra3.default.ensureDir(import_node_path4.default.join(projectRoot, `packages/${pkg2}/src`))));
-      await Promise.all(
-        Object.entries(getSdkWorkspacePackageFiles(npmScope, enterpriseFlags)).map(
-          ([filePath, content]) => writeFile(projectRoot, filePath, content)
-        )
-      );
+      const sdkFiles = getSdkWorkspacePackageFiles(npmScope, enterpriseFlags);
+      const sdkEntries = config.lite ? Object.entries(sdkFiles).filter(([filePath]) => filePath.startsWith("packages/query-client/")) : Object.entries(sdkFiles);
+      await Promise.all(sdkEntries.map(([filePath, content]) => writeFile(projectRoot, filePath, content)));
     }
   }
   await Promise.all(
@@ -19955,13 +20004,15 @@ async function generateParentWorkspace(projectRoot, config) {
       sharedApps[0] ?? "corelib",
       config.template === "tsx",
       includeWorkspacePackages,
-      includeWorkspacePackages && isEnterpriseParent ? enterpriseFlags : void 0,
+      includeWorkspacePackages && isEnterpriseParent && !config.lite,
+      includeWorkspacePackages && isEnterpriseParent && !config.lite ? enterpriseFlags : void 0,
       federationOs,
       controlPlane,
-      config.appType === "parent" && config.federation
+      config.appType === "parent" && config.federation,
+      config.lite
     )
   );
-  await writeFile(projectRoot, ".npmrc", "install-strategy=hoisted\nfund=false\n");
+  await writeFile(projectRoot, ".npmrc", getNpmrcContent());
   await writeFile(
     projectRoot,
     "README.md",
@@ -19994,20 +20045,27 @@ async function generateParentWorkspace(projectRoot, config) {
   await writeFile(projectRoot, "scripts/security-scan-placeholder.js", getSecurityScanPlaceholderScript());
   if (config.template === "tsx" || config.template === "jsx" && isEnterpriseParent) {
     if (config.template === "tsx") {
-      await writeEnterpriseQualityRootFiles(projectRoot, config.projectName, allApps, true);
-      await augmentWorkspacePackagesTsconfig(projectRoot);
-      await Promise.all(allApps.map((appName) => augmentWorkspaceAppWithQuality(import_node_path4.default.join(projectRoot, "apps", appName))));
+      if (config.lite) {
+        await writeFile(projectRoot, "tsconfig.base.json", getTsconfigBaseJson());
+        await augmentWorkspacePackagesTsconfig(projectRoot);
+      } else {
+        await writeEnterpriseQualityRootFiles(projectRoot, config.projectName, allApps, true);
+        await augmentWorkspacePackagesTsconfig(projectRoot);
+        await Promise.all(allApps.map((appName) => augmentWorkspaceAppWithQuality(import_node_path4.default.join(projectRoot, "apps", appName))));
+      }
     }
     if (isEnterpriseParent) {
       await augmentWorkspacePackagesForProjectReferences(projectRoot);
-      await Promise.all(
-        Object.entries(getEnterprisePlatformRootFiles(config.projectName, enterpriseFlags)).map(
-          ([filePath, content]) => writeFile(projectRoot, filePath, content)
-        )
-      );
+      if (!config.lite) {
+        await Promise.all(
+          Object.entries(getEnterprisePlatformRootFiles(config.projectName, enterpriseFlags)).map(
+            ([filePath, content]) => writeFile(projectRoot, filePath, content)
+          )
+        );
+      }
       const sharedAppName = sharedApps[0] ?? "corelib";
       await Promise.all(
-        Object.entries(getPlatformFrameworkFiles(config.projectName, allApps, sharedAppName, npmScope)).map(
+        Object.entries(getPlatformFrameworkFiles(config.projectName, allApps, sharedAppName, npmScope, { lite: config.lite })).map(
           ([filePath, content]) => writeFile(projectRoot, filePath, content)
         )
       );
@@ -21628,7 +21686,7 @@ ${getFederationSharedBlockJs(enterprise, "host", platformPreset)}
 }
 `;
 }
-function getWorkspacePackageJson(projectName, allApps, remotes, sharedApp, includeWorkspacePackages, includeEnterpriseQuality, enterpriseFlags, federationOs = false, controlPlane = false, includeInfraScripts = false) {
+function getWorkspacePackageJson(projectName, allApps, remotes, sharedApp, includeWorkspacePackages, includeEnterpriseQuality, enterpriseFlags, federationOs = false, controlPlane = false, includeInfraScripts = false, lite = false) {
   const envs = ["dev", "staging", "uat", "production"];
   const hostApp = allApps[0];
   const scripts = {
@@ -21700,7 +21758,7 @@ function getWorkspacePackageJson(projectName, allApps, remotes, sharedApp, inclu
       remotes
     }
   };
-  if (includeEnterpriseQuality) {
+  if (includeEnterpriseQuality && !lite) {
     applyEnterpriseQualityRootPackageJson(packageJson.scripts, packageJson.devDependencies, allApps);
     packageJson.overrides = getWorkspaceNpmOverrides();
   }
@@ -21897,7 +21955,7 @@ async function resolveWorkspaceContext(workspaceRoot) {
   const controlPlane = !federationOs && await import_fs_extra3.default.pathExists(import_node_path4.default.join(workspaceRoot, "apps/workflow-monitor-app"));
   const includeWorkspacePackages = await import_fs_extra3.default.pathExists(import_node_path4.default.join(workspaceRoot, "packages/shared-ui"));
   const includeInfraScripts = await import_fs_extra3.default.pathExists(import_node_path4.default.join(workspaceRoot, "infrastructure/nginx"));
-  const includeEnterpriseQuality = template === "tsx" && (enterprise || includeWorkspacePackages);
+  const includeEnterpriseQuality = template === "tsx" && (enterprise || includeWorkspacePackages) && await import_fs_extra3.default.pathExists(import_node_path4.default.join(workspaceRoot, ".eslintrc.cjs"));
   return {
     workspaceRoot,
     projectName: mf.name ?? import_node_path4.default.basename(workspaceRoot),
@@ -22094,6 +22152,7 @@ function printHelp() {
   console.log("  --shared=sharedlib");
   console.log("  --docker=true|false   (default: true)");
   console.log("  --federation=true|false");
+  console.log("  --lite              Faster npm install (skip ESLint/Vitest/Husky + optional SDK packages)");
   console.log("");
   console.log("Enterprise platform flags (parent monorepo):");
   console.log("  --auth              OAuth/OIDC auth foundation");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@multisystemsuite/create-mf-app",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "description": "Production-ready TypeScript CLI to scaffold enterprise microfrontend apps with React, Vite and Module Federation.",
   "license": "MIT",
   "keywords": [