create-awesome-node-app 0.4.26 → 0.4.27

package/README.md

@@ -67,6 +67,21 @@ create-awesome-node-app --template react-vite-boilerplate --addons jotai materia
 
 This example uses the `react-vite-boilerplate` template and applies the `jotai`, `material-ui`, and `github-setup` extensions.
 
+### Listing Templates and Addons
+
+You can list all available templates and addons using the following flags:
+
+```sh
+# List all available templates
+create-awesome-node-app --list-templates
+
+# List all available addons
+create-awesome-node-app --list-addons
+
+# List addons compatible with a specific template
+create-awesome-node-app --template react-vite-boilerplate --list-addons
+```
+
 ## 🔗 Full List of Templates and Extensions
 
 You can find the full list of available templates and extensions in the [cna-templates repository](https://github.com/Create-Node-App/cna-templates).

package/dist/index.cjs

@@ -1342,14 +1342,14 @@ var require_templates = __commonJS({
       }
       return results;
     }
-    function buildStyle(chalk2, styles) {
+    function buildStyle(chalk3, styles) {
       const enabled = {};
       for (const layer of styles) {
         for (const style of layer.styles) {
           enabled[style[0]] = layer.inverse ? null : style.slice(1);
         }
       }
-      let current = chalk2;
+      let current = chalk3;
       for (const [styleName, styles2] of Object.entries(enabled)) {
         if (!Array.isArray(styles2)) {
           continue;
@@ -1361,7 +1361,7 @@ var require_templates = __commonJS({
       }
       return current;
     }
-    module2.exports = (chalk2, temporary) => {
+    module2.exports = (chalk3, temporary) => {
       const styles = [];
       const chunks = [];
       let chunk = [];
@@ -1371,13 +1371,13 @@ var require_templates = __commonJS({
         } else if (style) {
           const string = chunk.join("");
           chunk = [];
-          chunks.push(styles.length === 0 ? string : buildStyle(chalk2, styles)(string));
+          chunks.push(styles.length === 0 ? string : buildStyle(chalk3, styles)(string));
           styles.push({ inverse, styles: parseStyle(style) });
         } else if (close) {
           if (styles.length === 0) {
             throw new Error("Found extraneous } in Chalk template literal");
           }
-          chunks.push(buildStyle(chalk2, styles)(chunk.join("")));
+          chunks.push(buildStyle(chalk3, styles)(chunk.join("")));
           chunk = [];
           styles.pop();
         } else {
@@ -1425,16 +1425,16 @@ var require_source = __commonJS({
       }
     };
     var chalkFactory = (options) => {
-      const chalk3 = {};
-      applyOptions(chalk3, options);
-      chalk3.template = (...arguments_) => chalkTag(chalk3.template, ...arguments_);
-      Object.setPrototypeOf(chalk3, Chalk.prototype);
-      Object.setPrototypeOf(chalk3.template, chalk3);
-      chalk3.template.constructor = () => {
+      const chalk4 = {};
+      applyOptions(chalk4, options);
+      chalk4.template = (...arguments_) => chalkTag(chalk4.template, ...arguments_);
+      Object.setPrototypeOf(chalk4, Chalk.prototype);
+      Object.setPrototypeOf(chalk4.template, chalk4);
+      chalk4.template.constructor = () => {
         throw new Error("`chalk.constructor()` is deprecated. Use `new chalk.Instance()` instead.");
       };
-      chalk3.template.Instance = ChalkClass;
-      return chalk3.template;
+      chalk4.template.Instance = ChalkClass;
+      return chalk4.template;
     };
     function Chalk(options) {
       return chalkFactory(options);
@@ -1545,7 +1545,7 @@ var require_source = __commonJS({
       return openAll + string + closeAll;
     };
     var template;
-    var chalkTag = (chalk3, ...strings) => {
+    var chalkTag = (chalk4, ...strings) => {
       const [firstString] = strings;
       if (!isArray(firstString) || !isArray(firstString.raw)) {
         return strings.join(" ");
@@ -1561,20 +1561,20 @@ var require_source = __commonJS({
       if (template === void 0) {
         template = require_templates();
       }
-      return template(chalk3, parts.join(""));
+      return template(chalk4, parts.join(""));
     };
     Object.defineProperties(Chalk.prototype, styles);
-    var chalk2 = Chalk();
-    chalk2.supportsColor = stdoutColor;
-    chalk2.stderr = Chalk({ level: stderrColor ? stderrColor.level : 0 });
-    chalk2.stderr.supportsColor = stderrColor;
-    module2.exports = chalk2;
+    var chalk3 = Chalk();
+    chalk3.supportsColor = stdoutColor;
+    chalk3.stderr = Chalk({ level: stderrColor ? stderrColor.level : 0 });
+    chalk3.stderr.supportsColor = stderrColor;
+    module2.exports = chalk3;
   }
 });
 
 // src/index.ts
 var import_commander = require("commander");
-var import_chalk = __toESM(require_source(), 1);
+var import_chalk2 = __toESM(require_source(), 1);
 var import_semver = __toESM(require("semver"), 1);
 var import_core = require("@create-node-app/core");
 
@@ -1612,12 +1612,24 @@ var getTemplateCategories = async (cliArgs) => {
     return [cliArgs.category];
   }
   const templateData = await getTemplateData();
+  if (templateData.categories && templateData.categories.length > 0) {
+    return templateData.categories.map((category) => category.slug);
+  }
   const categories = /* @__PURE__ */ new Set();
   templateData.templates.forEach((template) => {
     categories.add(template.category);
   });
   return Array.from(categories);
 };
+var getCategoryData = async (categorySlug) => {
+  const templateData = await getTemplateData();
+  if (templateData.categories && templateData.categories.length > 0) {
+    return templateData.categories.find(
+      (category) => category.slug === categorySlug
+    );
+  }
+  return void 0;
+};
 var getTemplatesForCategory = async (category, cliArgs) => {
   const selectedCategory = (cliArgs == null ? void 0 : cliArgs.category) || category;
   if (!selectedCategory) {
@@ -1661,63 +1673,83 @@ var isValidUrl = (url) => {
     return false;
   }
 };
-var getCnaOptions = async (options) => {
+var processNonInteractiveOptions = async (options) => {
   const categories = await getTemplateCategories();
-  if (import_ci_info.isCI || !options.interactive) {
-    let matchedTemplate;
-    if (options.template && !isValidUrl(options.template)) {
-      const allTemplates = (await Promise.all(
-        categories.map((category) => getTemplatesForCategory(category))
-      )).flat();
-      matchedTemplate = allTemplates.find(
-        (template) => template.slug === options.template
+  let matchedTemplate;
+  const templatesOrExtensions = [];
+  if (options.template && !isValidUrl(options.template)) {
+    const allTemplates = (await Promise.all(
+      categories.map((category) => getTemplatesForCategory(category))
+    )).flat();
+    matchedTemplate = allTemplates.find(
+      (template) => template.slug === options.template
+    );
+    if (matchedTemplate) {
+      templatesOrExtensions.push({ url: matchedTemplate.url });
+      if (matchedTemplate.customOptions) {
+        matchedTemplate.customOptions.forEach((customOption) => {
+          if (customOption.name && customOption.initial !== void 0) {
+            options[customOption.name] = customOption.initial;
+          }
+        });
+      }
+    } else {
+      throw new Error(
+        `Invalid template slug: '${options.template}'. Please provide a valid template slug.`
       );
-      if (matchedTemplate) {
-        options.template = matchedTemplate.url;
-        if (matchedTemplate.customOptions) {
-          matchedTemplate.customOptions.forEach((customOption) => {
-            if (customOption.name && customOption.initial !== void 0) {
-              options[customOption.name] = customOption.initial;
-            }
-          });
+    }
+  } else if (options.template) {
+    templatesOrExtensions.push({ url: options.template });
+  }
+  if (options.addons && Array.isArray(options.addons)) {
+    const extensionsGroupedByCategory = await getExtensionsGroupedByCategory([
+      (matchedTemplate == null ? void 0 : matchedTemplate.type) || "custom",
+      "all"
+    ]);
+    const extensions = options.addons.map((addon) => {
+      if (!isValidUrl(addon)) {
+        for (const extensions2 of Object.values(extensionsGroupedByCategory)) {
+          const matchedExtension = extensions2.find(
+            (extension) => extension.slug === addon
+          );
+          if (matchedExtension) {
+            return matchedExtension.url;
+          }
         }
-      } else {
         throw new Error(
-          `Invalid template slug: '${options.template}'. Please provide a valid template slug.`
+          `Invalid extension slug: '${addon}'. Please provide a valid extension slug.`
         );
       }
-    }
-    if (options.addons && Array.isArray(options.addons)) {
-      const extensionsGroupedByCategory2 = await getExtensionsGroupedByCategory([
-        (matchedTemplate == null ? void 0 : matchedTemplate.type) || "custom",
-        "all"
-      ]);
-      options.addons = options.addons.map((addon) => {
-        if (!isValidUrl(addon)) {
-          for (const extensions of Object.values(extensionsGroupedByCategory2)) {
-            const matchedExtension = extensions.find(
-              (extension) => extension.slug === addon
-            );
-            if (matchedExtension) {
-              return matchedExtension.url;
-            }
-          }
-          throw new Error(
-            `Invalid extension slug: '${addon}'. Please provide a valid extension slug.`
-          );
-        }
-        return addon;
-      });
-    }
-    if (options.verbose) {
-      console.log(JSON.stringify(options, null, 2));
-    }
-    return options;
+      return addon;
+    }).map((addon) => ({ url: addon }));
+    templatesOrExtensions.push(...extensions);
   }
+  if (options.extend && Array.isArray(options.extend)) {
+    const additionalExtensions = options.extend.filter(Boolean).map((extension) => ({ url: extension }));
+    templatesOrExtensions.push(...additionalExtensions);
+  }
+  options.templatesOrExtensions = templatesOrExtensions;
+  if (options.verbose) {
+    console.log(JSON.stringify(options, null, 2));
+  }
+  return options;
+};
+var processInteractiveOptions = async (options) => {
+  const categories = await getTemplateCategories();
+  const categoryDataPromises = categories.map(async (categorySlug) => {
+    const categoryData = await getCategoryData(categorySlug);
+    return {
+      slug: categorySlug,
+      name: (categoryData == null ? void 0 : categoryData.name) || categorySlug,
+      description: (categoryData == null ? void 0 : categoryData.description) || ""
+    };
+  });
+  const categoryDataList = await Promise.all(categoryDataPromises);
   const categoriesOptions = [
-    ...categories.map((category) => ({
-      title: category,
-      value: category
+    ...categoryDataList.map((category) => ({
+      title: category.name,
+      value: category.slug,
+      description: category.description
     })),
     {
       title: "None of the above",
@@ -1811,13 +1843,16 @@ var getCnaOptions = async (options) => {
     (existingTemplate == null ? void 0 : existingTemplate.type) || "custom",
     "all"
   ]);
-  for (const [category, extensions] of Object.entries(
+  for (const [categorySlug, extensions] of Object.entries(
     extensionsGroupedByCategory
   )) {
+    const categoryData = await getCategoryData(categorySlug);
+    const categoryName = (categoryData == null ? void 0 : categoryData.name) || categorySlug;
+    const categoryDescription = (categoryData == null ? void 0 : categoryData.description) || "";
     const { selected } = await (0, import_prompts.default)({
       type: "multiselect",
       name: "selected",
-      message: `Select extensions for ${category}`,
+      message: `Select extensions for ${categoryName}${categoryDescription ? `: ${categoryDescription}` : ""}`,
       choices: extensions.map((extension) => {
         var _a;
         return {
@@ -1868,11 +1903,19 @@ var getCnaOptions = async (options) => {
   }
   return nextOptions;
 };
+var getCnaOptions = async (options) => {
+  const shouldUseInteractiveMode = !import_ci_info.isCI && options.interactive;
+  if (shouldUseInteractiveMode) {
+    return processInteractiveOptions(options);
+  } else {
+    return processNonInteractiveOptions(options);
+  }
+};
 
 // package.json
 var package_default = {
   name: "create-awesome-node-app",
-  version: "0.4.26",
+  version: "0.4.27",
   type: "module",
   description: "Command line tool to create Node apps with a lot of different templates and extensions.",
   license: "MIT",
@@ -1937,11 +1980,87 @@ var package_default = {
   }
 };
 
+// src/list.ts
+var import_chalk = __toESM(require_source(), 1);
+var listTemplates = async () => {
+  const categories = await getTemplateCategories();
+  console.log(import_chalk.default.bold.blue("\nAvailable Templates:"));
+  for (const categorySlug of categories) {
+    const categoryData = await getCategoryData(categorySlug);
+    const templates = await getTemplatesForCategory(categorySlug);
+    const categoryName = (categoryData == null ? void 0 : categoryData.name) || categorySlug;
+    console.log(import_chalk.default.bold.green(`
+${categoryName}:`));
+    if (categoryData == null ? void 0 : categoryData.description) {
+      console.log(`  ${categoryData.description}`);
+    }
+    templates.forEach((template) => {
+      console.log(
+        `  ${import_chalk.default.yellow(template.name)} (${import_chalk.default.cyan(template.slug)})`
+      );
+      console.log(`    ${template.description}`);
+      if (template.labels && template.labels.length > 0) {
+        console.log(`    Keywords: ${template.labels.join(", ")}`);
+      }
+    });
+  }
+};
+var listAddons = async ({
+  templateSlug,
+  templateType
+}) => {
+  if (templateSlug && !templateType) {
+    templateType = await getTemplateTypeFromSlug(templateSlug);
+  }
+  const types = templateType ? [templateType, "all"] : ["all"];
+  const extensionsGroupedByCategory = await getExtensionsGroupedByCategory(
+    types
+  );
+  console.log(import_chalk.default.bold.blue("\nAvailable Addons:"));
+  if (templateSlug) {
+    console.log(
+      import_chalk.default.bold.green(`
+Compatible with template: ${templateSlug}`)
+    );
+  }
+  for (const [categorySlug, extensions] of Object.entries(
+    extensionsGroupedByCategory
+  )) {
+    const categoryData = await getCategoryData(categorySlug);
+    const categoryName = (categoryData == null ? void 0 : categoryData.name) || categorySlug;
+    console.log(import_chalk.default.bold.green(`
+${categoryName}:`));
+    if (categoryData == null ? void 0 : categoryData.description) {
+      console.log(`  ${categoryData.description}`);
+    }
+    extensions.forEach((extension) => {
+      console.log(
+        `  ${import_chalk.default.yellow(extension.name)} (${import_chalk.default.cyan(extension.slug)})`
+      );
+      console.log(`    ${extension.description}`);
+      if (extension.labels && extension.labels.length > 0) {
+        console.log(`    Keywords: ${extension.labels.join(", ")}`);
+      }
+    });
+  }
+};
+var getTemplateTypeFromSlug = async (templateSlug) => {
+  const categories = await getTemplateCategories();
+  for (const category of categories) {
+    const templates = await getTemplatesForCategory(category);
+    const template = templates.find((t) => t.slug === templateSlug);
+    if (template) {
+      return template.type;
+    }
+  }
+  return void 0;
+};
+
 // src/index.ts
 var program = new import_commander.Command();
 var main = async () => {
   let projectName = "my-project";
-  program.version(package_default.version).arguments("[project-directory]").usage(`${import_chalk.default.green("[project-directory]")} [options]`).option("-v, --verbose", "print additional logs").option("-i, --info", "print environment debug info").option(
+  program.version(package_default.version).arguments("[project-directory]").usage(`${import_chalk2.default.green("[project-directory]")} [options]`).option("-v, --verbose", "print additional logs").option("-i, --info", "print environment debug info").option(
     "--no-install",
     "Generate package.json without installing dependencies"
   ).option(
@@ -1950,7 +2069,7 @@ var main = async () => {
   ).option(
     "--addons [extensions...]",
     "specify extensions to apply for the boilerplate generation"
-  ).option("--use-yarn", "use yarn instead of npm or pnpm").option("--use-pnpm", "use pnpm instead of yarn or npm").option("--interactive", "run in interactive mode to select options", false).action((providedProjectName) => {
+  ).option("--use-yarn", "use yarn instead of npm or pnpm").option("--use-pnpm", "use pnpm instead of yarn or npm").option("--interactive", "run in interactive mode to select options", false).option("--list-templates", "list all available templates").option("--list-addons", "list all available addons").action((providedProjectName) => {
     projectName = providedProjectName || projectName;
   });
   program.parse(process.argv);
@@ -1960,7 +2079,7 @@ var main = async () => {
   if (latest && import_semver.default.lt(package_default.version, latest)) {
     console.log();
     console.error(
-      import_chalk.default.yellow(
+      import_chalk2.default.yellow(
         `You are running \`create-awesome-node-app\` ${package_default.version}, which is behind the latest release (${latest}).
 
 We recommend always using the latest version of create-awesome-node-app if possible.`
@@ -1968,10 +2087,19 @@ We recommend always using the latest version of create-awesome-node-app if possi
     );
     return;
   }
-  const options = await getCnaOptions({ ...opts, projectName });
-  const { useYarn, usePnpm, ...restOptions } = options;
+  if (opts.listTemplates) {
+    await listTemplates();
+    return;
+  }
+  if (opts.listAddons) {
+    await listAddons({
+      templateSlug: opts.template
+    });
+    return;
+  }
+  const { useYarn, usePnpm, ...restOpts } = opts;
   const packageManager = useYarn ? "yarn" : usePnpm ? "pnpm" : "npm";
-  const templatesOrExtensions = [restOptions.template].concat(Array.isArray(restOptions.addons) ? restOptions.addons : []).concat(Array.isArray(restOptions.extend) ? restOptions.extend : []).reduce((acc, templateOrExtension) => {
+  const templatesOrExtensions = [restOpts.template].concat(Array.isArray(restOpts.extend) ? restOpts.extend : []).reduce((acc, templateOrExtension) => {
     if (!templateOrExtension) {
       return acc;
     }
@@ -1981,7 +2109,7 @@ We recommend always using the latest version of create-awesome-node-app if possi
   }, []);
   return (0, import_core.createNodeApp)(
     projectName,
-    { ...restOptions, packageManager, templatesOrExtensions, projectName },
+    { ...restOpts, packageManager, templatesOrExtensions, projectName },
     getCnaOptions
   );
 };

package/dist/index.js

@@ -1348,14 +1348,14 @@ var require_templates = __commonJS({
       }
       return results;
     }
-    function buildStyle(chalk2, styles) {
+    function buildStyle(chalk3, styles) {
       const enabled = {};
       for (const layer of styles) {
         for (const style of layer.styles) {
           enabled[style[0]] = layer.inverse ? null : style.slice(1);
         }
       }
-      let current = chalk2;
+      let current = chalk3;
       for (const [styleName, styles2] of Object.entries(enabled)) {
         if (!Array.isArray(styles2)) {
           continue;
@@ -1367,7 +1367,7 @@ var require_templates = __commonJS({
       }
       return current;
     }
-    module.exports = (chalk2, temporary) => {
+    module.exports = (chalk3, temporary) => {
       const styles = [];
       const chunks = [];
       let chunk = [];
@@ -1377,13 +1377,13 @@ var require_templates = __commonJS({
         } else if (style) {
           const string = chunk.join("");
           chunk = [];
-          chunks.push(styles.length === 0 ? string : buildStyle(chalk2, styles)(string));
+          chunks.push(styles.length === 0 ? string : buildStyle(chalk3, styles)(string));
           styles.push({ inverse, styles: parseStyle(style) });
         } else if (close) {
           if (styles.length === 0) {
             throw new Error("Found extraneous } in Chalk template literal");
           }
-          chunks.push(buildStyle(chalk2, styles)(chunk.join("")));
+          chunks.push(buildStyle(chalk3, styles)(chunk.join("")));
           chunk = [];
           styles.pop();
         } else {
@@ -1431,16 +1431,16 @@ var require_source = __commonJS({
       }
     };
     var chalkFactory = (options) => {
-      const chalk3 = {};
-      applyOptions(chalk3, options);
-      chalk3.template = (...arguments_) => chalkTag(chalk3.template, ...arguments_);
-      Object.setPrototypeOf(chalk3, Chalk.prototype);
-      Object.setPrototypeOf(chalk3.template, chalk3);
-      chalk3.template.constructor = () => {
+      const chalk4 = {};
+      applyOptions(chalk4, options);
+      chalk4.template = (...arguments_) => chalkTag(chalk4.template, ...arguments_);
+      Object.setPrototypeOf(chalk4, Chalk.prototype);
+      Object.setPrototypeOf(chalk4.template, chalk4);
+      chalk4.template.constructor = () => {
         throw new Error("`chalk.constructor()` is deprecated. Use `new chalk.Instance()` instead.");
       };
-      chalk3.template.Instance = ChalkClass;
-      return chalk3.template;
+      chalk4.template.Instance = ChalkClass;
+      return chalk4.template;
     };
     function Chalk(options) {
       return chalkFactory(options);
@@ -1551,7 +1551,7 @@ var require_source = __commonJS({
       return openAll + string + closeAll;
     };
     var template;
-    var chalkTag = (chalk3, ...strings) => {
+    var chalkTag = (chalk4, ...strings) => {
       const [firstString] = strings;
       if (!isArray(firstString) || !isArray(firstString.raw)) {
         return strings.join(" ");
@@ -1567,19 +1567,19 @@ var require_source = __commonJS({
       if (template === void 0) {
         template = require_templates();
       }
-      return template(chalk3, parts.join(""));
+      return template(chalk4, parts.join(""));
     };
     Object.defineProperties(Chalk.prototype, styles);
-    var chalk2 = Chalk();
-    chalk2.supportsColor = stdoutColor;
-    chalk2.stderr = Chalk({ level: stderrColor ? stderrColor.level : 0 });
-    chalk2.stderr.supportsColor = stderrColor;
-    module.exports = chalk2;
+    var chalk3 = Chalk();
+    chalk3.supportsColor = stdoutColor;
+    chalk3.stderr = Chalk({ level: stderrColor ? stderrColor.level : 0 });
+    chalk3.stderr.supportsColor = stderrColor;
+    module.exports = chalk3;
   }
 });
 
 // src/index.ts
-var import_chalk = __toESM(require_source(), 1);
+var import_chalk2 = __toESM(require_source(), 1);
 import { Command } from "commander";
 import semver from "semver";
 import {
@@ -1622,12 +1622,24 @@ var getTemplateCategories = async (cliArgs) => {
     return [cliArgs.category];
   }
   const templateData = await getTemplateData();
+  if (templateData.categories && templateData.categories.length > 0) {
+    return templateData.categories.map((category) => category.slug);
+  }
   const categories = /* @__PURE__ */ new Set();
   templateData.templates.forEach((template) => {
     categories.add(template.category);
   });
   return Array.from(categories);
 };
+var getCategoryData = async (categorySlug) => {
+  const templateData = await getTemplateData();
+  if (templateData.categories && templateData.categories.length > 0) {
+    return templateData.categories.find(
+      (category) => category.slug === categorySlug
+    );
+  }
+  return void 0;
+};
 var getTemplatesForCategory = async (category, cliArgs) => {
   const selectedCategory = (cliArgs == null ? void 0 : cliArgs.category) || category;
   if (!selectedCategory) {
@@ -1671,63 +1683,83 @@ var isValidUrl = (url) => {
     return false;
   }
 };
-var getCnaOptions = async (options) => {
+var processNonInteractiveOptions = async (options) => {
   const categories = await getTemplateCategories();
-  if (isCI || !options.interactive) {
-    let matchedTemplate;
-    if (options.template && !isValidUrl(options.template)) {
-      const allTemplates = (await Promise.all(
-        categories.map((category) => getTemplatesForCategory(category))
-      )).flat();
-      matchedTemplate = allTemplates.find(
-        (template) => template.slug === options.template
+  let matchedTemplate;
+  const templatesOrExtensions = [];
+  if (options.template && !isValidUrl(options.template)) {
+    const allTemplates = (await Promise.all(
+      categories.map((category) => getTemplatesForCategory(category))
+    )).flat();
+    matchedTemplate = allTemplates.find(
+      (template) => template.slug === options.template
+    );
+    if (matchedTemplate) {
+      templatesOrExtensions.push({ url: matchedTemplate.url });
+      if (matchedTemplate.customOptions) {
+        matchedTemplate.customOptions.forEach((customOption) => {
+          if (customOption.name && customOption.initial !== void 0) {
+            options[customOption.name] = customOption.initial;
+          }
+        });
+      }
+    } else {
+      throw new Error(
+        `Invalid template slug: '${options.template}'. Please provide a valid template slug.`
       );
-      if (matchedTemplate) {
-        options.template = matchedTemplate.url;
-        if (matchedTemplate.customOptions) {
-          matchedTemplate.customOptions.forEach((customOption) => {
-            if (customOption.name && customOption.initial !== void 0) {
-              options[customOption.name] = customOption.initial;
-            }
-          });
+    }
+  } else if (options.template) {
+    templatesOrExtensions.push({ url: options.template });
+  }
+  if (options.addons && Array.isArray(options.addons)) {
+    const extensionsGroupedByCategory = await getExtensionsGroupedByCategory([
+      (matchedTemplate == null ? void 0 : matchedTemplate.type) || "custom",
+      "all"
+    ]);
+    const extensions = options.addons.map((addon) => {
+      if (!isValidUrl(addon)) {
+        for (const extensions2 of Object.values(extensionsGroupedByCategory)) {
+          const matchedExtension = extensions2.find(
+            (extension) => extension.slug === addon
+          );
+          if (matchedExtension) {
+            return matchedExtension.url;
+          }
         }
-      } else {
         throw new Error(
-          `Invalid template slug: '${options.template}'. Please provide a valid template slug.`
+          `Invalid extension slug: '${addon}'. Please provide a valid extension slug.`
         );
       }
-    }
-    if (options.addons && Array.isArray(options.addons)) {
-      const extensionsGroupedByCategory2 = await getExtensionsGroupedByCategory([
-        (matchedTemplate == null ? void 0 : matchedTemplate.type) || "custom",
-        "all"
-      ]);
-      options.addons = options.addons.map((addon) => {
-        if (!isValidUrl(addon)) {
-          for (const extensions of Object.values(extensionsGroupedByCategory2)) {
-            const matchedExtension = extensions.find(
-              (extension) => extension.slug === addon
-            );
-            if (matchedExtension) {
-              return matchedExtension.url;
-            }
-          }
-          throw new Error(
-            `Invalid extension slug: '${addon}'. Please provide a valid extension slug.`
-          );
-        }
-        return addon;
-      });
-    }
-    if (options.verbose) {
-      console.log(JSON.stringify(options, null, 2));
-    }
-    return options;
+      return addon;
+    }).map((addon) => ({ url: addon }));
+    templatesOrExtensions.push(...extensions);
   }
+  if (options.extend && Array.isArray(options.extend)) {
+    const additionalExtensions = options.extend.filter(Boolean).map((extension) => ({ url: extension }));
+    templatesOrExtensions.push(...additionalExtensions);
+  }
+  options.templatesOrExtensions = templatesOrExtensions;
+  if (options.verbose) {
+    console.log(JSON.stringify(options, null, 2));
+  }
+  return options;
+};
+var processInteractiveOptions = async (options) => {
+  const categories = await getTemplateCategories();
+  const categoryDataPromises = categories.map(async (categorySlug) => {
+    const categoryData = await getCategoryData(categorySlug);
+    return {
+      slug: categorySlug,
+      name: (categoryData == null ? void 0 : categoryData.name) || categorySlug,
+      description: (categoryData == null ? void 0 : categoryData.description) || ""
+    };
+  });
+  const categoryDataList = await Promise.all(categoryDataPromises);
   const categoriesOptions = [
-    ...categories.map((category) => ({
-      title: category,
-      value: category
+    ...categoryDataList.map((category) => ({
+      title: category.name,
+      value: category.slug,
+      description: category.description
     })),
     {
       title: "None of the above",
@@ -1821,13 +1853,16 @@ var getCnaOptions = async (options) => {
     (existingTemplate == null ? void 0 : existingTemplate.type) || "custom",
     "all"
   ]);
-  for (const [category, extensions] of Object.entries(
+  for (const [categorySlug, extensions] of Object.entries(
     extensionsGroupedByCategory
   )) {
+    const categoryData = await getCategoryData(categorySlug);
+    const categoryName = (categoryData == null ? void 0 : categoryData.name) || categorySlug;
+    const categoryDescription = (categoryData == null ? void 0 : categoryData.description) || "";
     const { selected } = await prompts({
       type: "multiselect",
       name: "selected",
-      message: `Select extensions for ${category}`,
+      message: `Select extensions for ${categoryName}${categoryDescription ? `: ${categoryDescription}` : ""}`,
       choices: extensions.map((extension) => {
         var _a;
         return {
@@ -1878,11 +1913,19 @@ var getCnaOptions = async (options) => {
   }
   return nextOptions;
 };
+var getCnaOptions = async (options) => {
+  const shouldUseInteractiveMode = !isCI && options.interactive;
+  if (shouldUseInteractiveMode) {
+    return processInteractiveOptions(options);
+  } else {
+    return processNonInteractiveOptions(options);
+  }
+};
 
 // package.json
 var package_default = {
   name: "create-awesome-node-app",
-  version: "0.4.26",
+  version: "0.4.27",
   type: "module",
   description: "Command line tool to create Node apps with a lot of different templates and extensions.",
   license: "MIT",
@@ -1947,11 +1990,87 @@ var package_default = {
   }
 };
 
+// src/list.ts
+var import_chalk = __toESM(require_source(), 1);
+var listTemplates = async () => {
+  const categories = await getTemplateCategories();
+  console.log(import_chalk.default.bold.blue("\nAvailable Templates:"));
+  for (const categorySlug of categories) {
+    const categoryData = await getCategoryData(categorySlug);
+    const templates = await getTemplatesForCategory(categorySlug);
+    const categoryName = (categoryData == null ? void 0 : categoryData.name) || categorySlug;
+    console.log(import_chalk.default.bold.green(`
+${categoryName}:`));
+    if (categoryData == null ? void 0 : categoryData.description) {
+      console.log(`  ${categoryData.description}`);
+    }
+    templates.forEach((template) => {
+      console.log(
+        `  ${import_chalk.default.yellow(template.name)} (${import_chalk.default.cyan(template.slug)})`
+      );
+      console.log(`    ${template.description}`);
+      if (template.labels && template.labels.length > 0) {
+        console.log(`    Keywords: ${template.labels.join(", ")}`);
+      }
+    });
+  }
+};
+var listAddons = async ({
+  templateSlug,
+  templateType
+}) => {
+  if (templateSlug && !templateType) {
+    templateType = await getTemplateTypeFromSlug(templateSlug);
+  }
+  const types = templateType ? [templateType, "all"] : ["all"];
+  const extensionsGroupedByCategory = await getExtensionsGroupedByCategory(
+    types
+  );
+  console.log(import_chalk.default.bold.blue("\nAvailable Addons:"));
+  if (templateSlug) {
+    console.log(
+      import_chalk.default.bold.green(`
+Compatible with template: ${templateSlug}`)
+    );
+  }
+  for (const [categorySlug, extensions] of Object.entries(
+    extensionsGroupedByCategory
+  )) {
+    const categoryData = await getCategoryData(categorySlug);
+    const categoryName = (categoryData == null ? void 0 : categoryData.name) || categorySlug;
+    console.log(import_chalk.default.bold.green(`
+${categoryName}:`));
+    if (categoryData == null ? void 0 : categoryData.description) {
+      console.log(`  ${categoryData.description}`);
+    }
+    extensions.forEach((extension) => {
+      console.log(
+        `  ${import_chalk.default.yellow(extension.name)} (${import_chalk.default.cyan(extension.slug)})`
+      );
+      console.log(`    ${extension.description}`);
+      if (extension.labels && extension.labels.length > 0) {
+        console.log(`    Keywords: ${extension.labels.join(", ")}`);
+      }
+    });
+  }
+};
+var getTemplateTypeFromSlug = async (templateSlug) => {
+  const categories = await getTemplateCategories();
+  for (const category of categories) {
+    const templates = await getTemplatesForCategory(category);
+    const template = templates.find((t) => t.slug === templateSlug);
+    if (template) {
+      return template.type;
+    }
+  }
+  return void 0;
+};
+
 // src/index.ts
 var program = new Command();
 var main = async () => {
   let projectName = "my-project";
-  program.version(package_default.version).arguments("[project-directory]").usage(`${import_chalk.default.green("[project-directory]")} [options]`).option("-v, --verbose", "print additional logs").option("-i, --info", "print environment debug info").option(
+  program.version(package_default.version).arguments("[project-directory]").usage(`${import_chalk2.default.green("[project-directory]")} [options]`).option("-v, --verbose", "print additional logs").option("-i, --info", "print environment debug info").option(
     "--no-install",
     "Generate package.json without installing dependencies"
   ).option(
@@ -1960,7 +2079,7 @@ var main = async () => {
   ).option(
     "--addons [extensions...]",
     "specify extensions to apply for the boilerplate generation"
-  ).option("--use-yarn", "use yarn instead of npm or pnpm").option("--use-pnpm", "use pnpm instead of yarn or npm").option("--interactive", "run in interactive mode to select options", false).action((providedProjectName) => {
+  ).option("--use-yarn", "use yarn instead of npm or pnpm").option("--use-pnpm", "use pnpm instead of yarn or npm").option("--interactive", "run in interactive mode to select options", false).option("--list-templates", "list all available templates").option("--list-addons", "list all available addons").action((providedProjectName) => {
     projectName = providedProjectName || projectName;
   });
   program.parse(process.argv);
@@ -1970,7 +2089,7 @@ var main = async () => {
   if (latest && semver.lt(package_default.version, latest)) {
     console.log();
     console.error(
-      import_chalk.default.yellow(
+      import_chalk2.default.yellow(
         `You are running \`create-awesome-node-app\` ${package_default.version}, which is behind the latest release (${latest}).
 
 We recommend always using the latest version of create-awesome-node-app if possible.`
@@ -1978,10 +2097,19 @@ We recommend always using the latest version of create-awesome-node-app if possi
     );
     return;
   }
-  const options = await getCnaOptions({ ...opts, projectName });
-  const { useYarn, usePnpm, ...restOptions } = options;
+  if (opts.listTemplates) {
+    await listTemplates();
+    return;
+  }
+  if (opts.listAddons) {
+    await listAddons({
+      templateSlug: opts.template
+    });
+    return;
+  }
+  const { useYarn, usePnpm, ...restOpts } = opts;
   const packageManager = useYarn ? "yarn" : usePnpm ? "pnpm" : "npm";
-  const templatesOrExtensions = [restOptions.template].concat(Array.isArray(restOptions.addons) ? restOptions.addons : []).concat(Array.isArray(restOptions.extend) ? restOptions.extend : []).reduce((acc, templateOrExtension) => {
+  const templatesOrExtensions = [restOpts.template].concat(Array.isArray(restOpts.extend) ? restOpts.extend : []).reduce((acc, templateOrExtension) => {
     if (!templateOrExtension) {
       return acc;
     }
@@ -1991,7 +2119,7 @@ We recommend always using the latest version of create-awesome-node-app if possi
   }, []);
   return createNodeApp(
     projectName,
-    { ...restOptions, packageManager, templatesOrExtensions, projectName },
+    { ...restOpts, packageManager, templatesOrExtensions, projectName },
     getCnaOptions
   );
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-awesome-node-app",
-  "version": "0.4.26",
+  "version": "0.4.27",
   "type": "module",
   "description": "Command line tool to create Node apps with a lot of different templates and extensions.",
   "license": "MIT",