feat: update create-awesome-node-app to version 0.6.6 with improved scaffolding, added fs-extra dependency, and enhanced smoke tests

Author: ulises-jeremias

package-lock.json

@@ -1,5 +1,32 @@
 # create-awesome-node-app
 
+## 0.6.6
+
+### Patch Changes
+
+- Fix scaffolding so full template file tree is copied instead of producing an almost empty project.
+
+  Highlights:
+  - Repair file discovery: removed broken readdirp negative-only filter that yielded 0 matches; now enumerate all files then apply internal skip rules.
+  - Correct handling of special `[src]/` token directories so template source files land in the configured `srcDir`.
+  - Add missing runtime dependency `fs-extra` (previously only implicitly relied upon) to prevent potential runtime module resolution errors.
+  - Fix `appendTemplate` mapping so templated append operations render correctly (was incorrectly using plain append loader).
+  - Add verbose debug logs (behind `--verbose`) for template directory resolution, first discovered file, and total operations count to ease future diagnostics.
+  - Strengthen smoke test to assert presence of critical scaffold artifacts (e.g. `README.md`, `tsconfig.json`, `index.html`, `eslint.config.mjs`, `src/App.tsx`, `src/main.tsx`).
+
+  Result: Running the CLI now prepares and copies ~50 operations for the React Vite starter template (previously 0), restoring expected developer experience.
+
+- Updated dependencies
+  - @create-node-app/core@0.5.5
+
+## 0.6.5
+
+### Patch Changes
+
+- Fix
+- Updated dependencies
+  - @create-node-app/core@0.5.4
+
 ## 0.6.2
 
 ### Patch Changes

packages/create-awesome-node-app/CHANGELOG.md

@@ -1,6 +1,6 @@
 {
   "name": "create-awesome-node-app",
-  "version": "0.6.2",
+  "version": "0.6.6",
   "type": "module",
   "description": "Command line tool to create Node apps with a lot of different templates and extensions.",
   "license": "MIT",
@@ -28,7 +28,8 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./index.js"
+      "import": "./index.js",
+      "require": "./dist/index.cjs"
     }
   },
   "files": [
@@ -52,7 +53,7 @@
     "test": "node --test tests/**/*.test.mjs"
   },
   "dependencies": {
-    "@create-node-app/core": "*",
+    "@create-node-app/core": "^0.5.5",
     "axios": "^1.12.2",
     "ci-info": "^4.3.0",
     "commander": "^14.0.1",

packages/create-awesome-node-app/package.json

@@ -80,6 +80,7 @@ const main = async () => {
   const packageManager = useYarn ? "yarn" : usePnpm ? "pnpm" : "npm";
 
   const templatesOrExtensions: TemplateOrExtension[] = [restOpts.template]
+    .concat(Array.isArray(restOpts.extend) ? restOpts.extend : [])
     .filter(Boolean)
     .reduce((acc, templateOrExtension) => {
       if (!templateOrExtension) return acc;

packages/create-awesome-node-app/src/index.ts

@@ -35,6 +35,19 @@ try {
   if (!existsSync(projectDir)) {
     throw new Error('Project directory was not created');
   }
+  // Assert key scaffolded files exist
+  const expectedFiles = [
+    'README.md',
+    'tsconfig.json',
+    'index.html',
+    'eslint.config.mjs',
+    'src/App.tsx',
+    'src/main.tsx'
+  ];
+  const missing = expectedFiles.filter(f => !existsSync(join(projectDir, f)));
+  if (missing.length) {
+    throw new Error('Missing expected scaffold files: ' + missing.join(', '));
+  }
   console.log('Smoke test passed');
 } catch (err) {
   console.error('Smoke test failed:', err.message);

packages/create-awesome-node-app/tests/smoke.test.mjs

@@ -1,5 +1,27 @@
 # @create-node-app/core
 
+## 0.5.5
+
+### Patch Changes
+
+- Fix scaffolding so full template file tree is copied instead of producing an almost empty project.
+
+  Highlights:
+  - Repair file discovery: removed broken readdirp negative-only filter that yielded 0 matches; now enumerate all files then apply internal skip rules.
+  - Correct handling of special `[src]/` token directories so template source files land in the configured `srcDir`.
+  - Add missing runtime dependency `fs-extra` (previously only implicitly relied upon) to prevent potential runtime module resolution errors.
+  - Fix `appendTemplate` mapping so templated append operations render correctly (was incorrectly using plain append loader).
+  - Add verbose debug logs (behind `--verbose`) for template directory resolution, first discovered file, and total operations count to ease future diagnostics.
+  - Strengthen smoke test to assert presence of critical scaffold artifacts (e.g. `README.md`, `tsconfig.json`, `index.html`, `eslint.config.mjs`, `src/App.tsx`, `src/main.tsx`).
+
+  Result: Running the CLI now prepares and copies ~50 operations for the React Vite starter template (previously 0), restoring expected developer experience.
+
+## 0.5.4
+
+### Patch Changes
+
+- Fix
+
 ## 0.5.2
 
 ### Patch Changes

packages/create-node-app-core/CHANGELOG.md

@@ -5,6 +5,7 @@ import { execSync } from "child_process";
 import type { TemplateOrExtension } from "./loaders.js";
 export type { TemplateOrExtension } from "./loaders.js";
 import { createApp } from "./installer.js";
+export { downloadRepository } from "./git.js";
 
 export const checkNodeVersion = (
   requiredVersion: string,

packages/create-node-app-core/index.ts

@@ -9,6 +9,9 @@ import { promisify } from "util";
 const writeFileAsync = promisify(fs.writeFile);
 const copyFileAsync = promisify(fs.copyFile);
 
+// Token used inside templates to denote the source directory.
+// Templates name a directory literally `[src]` and files inside like `[src]/App.tsx.template`.
+// We map the prefix `[src]/` to the selected srcDir (e.g. `src/`).
 const SRC_PATH_PATTERN = "[src]/";
 const DEFAULT_SRC_PATH = "src/";
 
@@ -149,8 +152,6 @@ const batchedAppendFiles = async (
   await Promise.all(batchedPromises);
 };
 
-// AI tool specific filters removed (cursor/copilot). All files now processed uniformly.
-
 const copyLoader: FileLoader =
   ({ root, templateDir, verbose, srcDir }) =>
   async ({ path }) => {
@@ -271,8 +272,9 @@ const fileLoader: FileLoader =
         copy: copyLoader,
         append: appendLoader,
         copyTemplate: templateLoader,
-        appendTemplate: appendLoader,
-      };
+        // appendTemplate means treat as a template (interpolate) but append instead of overwrite
+        appendTemplate: templateLoader,
+      } as const;
 
       await loaders[mode]({
         root,
@@ -332,31 +334,55 @@ export const loadFiles = async ({
     const operations = [];
     for await (const { url: templateOrExtensionUrl } of templatesOrExtensions) {
       const templateDir = await getTemplateDirPath(templateOrExtensionUrl);
+      if (verbose) {
+        try {
+          const stat = fs.existsSync(templateDir)
+            ? fs.statSync(templateDir)
+            : undefined;
+          console.log(
+            pc.dim(
+              `[cna] Template dir resolved: ${templateDir} exists=${!!stat} isDir=$${stat?.isDirectory?.()}`,
+            ),
+          );
+        } catch {
+          // ignore
+        }
+      }
 
       if (
         fs.existsSync(templateDir) &&
         fs.statSync(templateDir).isDirectory()
       ) {
+        // readdirp requires at least one positive pattern when using negations; we'll include '**/*'
+        // and then filter out undesired files. This ensures templates are actually discovered.
+        let debugFirst = true;
+        // Collect all file entries without filters then skip undesired patterns manually
+        const skipGlobs = [
+          /\bpackage\.js$/,
+          /\bpackage\.json$/,
+          /\bpackage-lock\.json$/,
+          /\btemplate\.json$/,
+          /\byarn\.lock$/,
+          /\bpnpm-lock\.yaml$/,
+        ];
+        const skipManager = usePnpm
+          ? [/\.if-npm\./, /\.if-yarn\./]
+          : useYarn
+            ? [/\.if-npm\./, /\.if-pnpm\./]
+            : [/\.if-yarn\./, /\.if-pnpm\./];
+        const shouldSkip = (p: string) =>
+          [...skipGlobs, ...skipManager].some((rgx) => rgx.test(p));
+
         for await (const entry of readdirp(templateDir, {
-          fileFilter: [
-            "!package.js",
-            "!package.json",
-            "!package-lock.json",
-            "!template.json",
-            "!yarn.lock",
-            "!pnpm-lock.yaml",
-            // based on the package manager we want to ignore files containing
-            // the other package as condition.
-            // For example, if `usePnpm` is true, the we need to ignore
-            // all files with `.if-npm` or `.if-yarn` somewhere in the name.
-            ...(usePnpm
-              ? ["!*.if-npm.*", "!*.if-yarn.*"]
-              : useYarn
-                ? ["!*.if-npm.*", "!*.if-pnpm.*"]
-                : ["!*.if-yarn.*", "!*.if-pnpm.*"]),
-          ],
-          directoryFilter: ["!package"],
+          type: "files",
+          alwaysStat: false,
         })) {
+          if (shouldSkip(entry.path)) continue;
+          if (entry.path.startsWith("package/")) continue; // skip helper package dir
+          if (verbose && debugFirst) {
+            console.log(pc.dim(`[cna] First discovered file: ${entry.path}`));
+            debugFirst = false;
+          }
           operations.push({
             root,
             templateDir,
@@ -375,6 +401,21 @@ export const loadFiles = async ({
       }
     }
 
+    if (verbose) {
+      console.log(
+        pc.dim(
+          `[cna] Prepared ${operations.length} file operations from ${templatesOrExtensions.length} template(s)`,
+        ),
+      );
+      if (operations.length === 0) {
+        console.log(
+          pc.yellow(
+            "[cna] No files discovered. Check that the template repository was cloned and fileFilter patterns are correct.",
+          ),
+        );
+      }
+    }
+
     await Promise.all(
       operations.map((operation) => fileLoader(operation)(operation.entry)),
     );

packages/create-node-app-core/loaders.ts

@@ -1,6 +1,6 @@
 {
   "name": "@create-node-app/core",
-  "version": "0.5.2",
+  "version": "0.5.5",
   "type": "module",
   "main": "./dist/index.cjs",
   "types": "./dist/index.d.ts",
@@ -27,8 +27,8 @@
     "lint": "eslint '**/*.{ts,tsx,js}'",
     "lint:fix": "eslint '**/*.{ts,tsx,js}' --fix",
     "type-check": "tsc --noEmit",
-    "build": "tsup ./index.ts --format esm,cjs --dts --external simple-git,fs,path,child_process --no-splitting",
-    "dev": "tsup ./index.ts --format esm,cjs --watch --dts --external simple-git,fs,path,child_process --no-splitting"
+    "build": "tsup ./index.ts --format esm,cjs --dts --no-splitting",
+    "dev": "tsup ./index.ts --format esm,cjs --watch --dts --no-splitting"
   },
   "devDependencies": {
     "@create-node-app/eslint-config-ts": "*",
@@ -52,6 +52,7 @@
     "cross-spawn": "^7.0.6",
     "debug": "^4.4.3",
     "envinfo": "^7.14.0",
+    "fs-extra": "^11.2.0",
     "simple-git": "^3.28.0",
     "lodash.merge": "^4.6.2",
     "readdirp": "^4.1.2",