feat(cli): add template listing and viewing commands

involvex · involvex · commit 7e1e37413e00 · 2026-01-16T23:53:53.000+01:00
- Add `--list-templates` command to display available templates
- Add `--view-template &lt;Template-Name&gt;` command to show template details
- Update help documentation with new commands
- Bump version to 4.0.1
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -9,6 +9,8 @@
 - **templates:** Added `doctor` script to `react-native-app` template for easier troubleshooting.
 - **cli:** Improved entry point detection logic for better compatibility with `npx` and global installs.
 - **cli:** Added safeguards to prevent overwriting existing configuration files (`tsconfig.json`, `eslint.config.js`, `.prettierrc`) if provided by the template.
+- **cli:** Added `--list-templates` command to list all available templates.
+- **cli:** Added `--view-template <Template-Name>` command to view detailed information about a specific template.
 
 ### Bug Fixes
 
diff --git a/dist/create-wizard.js b/dist/create-wizard.js
@@ -17502,15 +17502,17 @@ if (args.includes("-h") || args.includes("--help")) {
     Initializes a new project using an interactive wizard.
 
     Arguments:
-      projectName         The name of the project to create. If provided, the wizard will skip the project name prompt.
+      projectName           The name of the project to create. If provided, the wizard will skip the project name prompt.
 
     Options:
-      -v, --version         Output the current version and exit.
-      -h, --help            Display this help message and exit.
-      --plugin              Configure and install a new plugin (e.g., Prettier, ESLint).
-      --create-test         Set up a new test framework for the project.
-      --license             Generate a new LICENSE file.
-      --debug=TRUE          Enable debug logging.
+      -v, --version                     Output the current version and exit.
+      -h, --help                        Display this help message and exit.
+      --plugin                          Configure and install a new plugin (e.g., Prettier, ESLint).
+      --create-test                     Set up a new test framework for the project.
+      --license                         Generate a new LICENSE file.
+      --debug=TRUE                      Enable debug logging.
+      --list-templates                  List all available deployment templates.
+      --view-template <Template-Name>   View more information about a specific template by name.
   `);
   process.exit(0);
 }
@@ -18107,6 +18109,40 @@ if (resolve(process.argv[1]) === resolve(fileURLToPath3(import.meta.url))) {
     main3({
       /* dependencies */
     });
+  } else if (userArgs.includes("--list-templates")) {
+    const templatesPath = join4(dirname(fileURLToPath3(import.meta.url)), "..", "template-library");
+    const templates = _fs3.readdirSync(templatesPath).filter((file) => {
+      const filePath = join4(templatesPath, file);
+      return _fs3.statSync(filePath).isDirectory();
+    });
+    console.log("Available Templates:");
+    templates.forEach((t2) => console.log(`- ${t2}`));
+    process.exit(0);
+  } else if (userArgs.includes("--view-template")) {
+    const templateNameIndex = userArgs.indexOf("--view-template") + 1;
+    const templateName = userArgs[templateNameIndex];
+    if (!templateName || templateName.startsWith("--")) {
+      console.error("Error: Please provide a template name.");
+      process.exit(1);
+    }
+    const templatesPath = join4(dirname(fileURLToPath3(import.meta.url)), "..", "template-library");
+    const templateDir = join4(templatesPath, templateName);
+    if (!_fs3.existsSync(templateDir)) {
+      console.error(`Error: Template '${templateName}' not found.`);
+      process.exit(1);
+    }
+    console.log(`Template: ${templateName}`);
+    const templateJsonPath = join4(templateDir, "template.json");
+    if (_fs3.existsSync(templateJsonPath)) {
+      const templateJson = JSON.parse(_fs3.readFileSync(templateJsonPath, "utf-8"));
+      console.log("Configuration:", JSON.stringify(templateJson, null, 2));
+    }
+    const readmePath = join4(templateDir, "README.md");
+    if (_fs3.existsSync(readmePath)) {
+      console.log("\n--- README ---");
+      console.log(_fs3.readFileSync(readmePath, "utf-8"));
+    }
+    process.exit(0);
   } else {
     main4({});
   }
diff --git a/docs/changelog/v4.0.0.md b/docs/changelog/v4.0.0.md
@@ -15,6 +15,8 @@ tags: [release]
 - **templates:** Added `doctor` script to `react-native-app` template for easier troubleshooting.
 - **cli:** Improved entry point detection logic for better compatibility with `npx` and global installs.
 - **cli:** Added safeguards to prevent overwriting existing configuration files (`tsconfig.json`, `eslint.config.js`, `.prettierrc`) if provided by the template.
+- **cli:** Added `--list-templates` command to list all available templates.
+- **cli:** Added `--view-template <Template-Name>` command to view detailed information about a specific template.
 
 ### Bug Fixes
 
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@involvex/create-wizard",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "description": "create everything with ease interactive ",
   "keywords": [
     "cli",
diff --git a/scripts/create-app.js b/scripts/create-app.js
@@ -30,15 +30,17 @@ if (args.includes('-h') || args.includes('--help')) {
     Initializes a new project using an interactive wizard.
 
     Arguments:
-      projectName         The name of the project to create. If provided, the wizard will skip the project name prompt.
+      projectName           The name of the project to create. If provided, the wizard will skip the project name prompt.
 
     Options:
-      -v, --version         Output the current version and exit.
-      -h, --help            Display this help message and exit.
-      --plugin              Configure and install a new plugin (e.g., Prettier, ESLint).
-      --create-test         Set up a new test framework for the project.
-      --license             Generate a new LICENSE file.
-      --debug=TRUE          Enable debug logging.
+      -v, --version                     Output the current version and exit.
+      -h, --help                        Display this help message and exit.
+      --plugin                          Configure and install a new plugin (e.g., Prettier, ESLint).
+      --create-test                     Set up a new test framework for the project.
+      --license                         Generate a new LICENSE file.
+      --debug=TRUE                      Enable debug logging.
+      --list-templates                  List all available deployment templates.
+      --view-template <Template-Name>   View more information about a specific template by name.
   `)
   process.exit(0)
 }
@@ -728,6 +730,45 @@ if (resolve(process.argv[1]) === resolve(fileURLToPath(import.meta.url))) {
     createTestSetup({
       /* dependencies */
     })
+  } else if (userArgs.includes('--list-templates')) {
+    const templatesPath = join(dirname(fileURLToPath(import.meta.url)), '..', 'template-library')
+    const templates = _fs.readdirSync(templatesPath).filter(file => {
+      const filePath = join(templatesPath, file)
+      return _fs.statSync(filePath).isDirectory()
+    })
+    console.log('Available Templates:')
+    templates.forEach(t => console.log(`- ${t}`))
+    process.exit(0)
+  } else if (userArgs.includes('--view-template')) {
+    const templateNameIndex = userArgs.indexOf('--view-template') + 1
+    const templateName = userArgs[templateNameIndex]
+
+    if (!templateName || templateName.startsWith('--')) {
+      console.error('Error: Please provide a template name.')
+      process.exit(1)
+    }
+
+    const templatesPath = join(dirname(fileURLToPath(import.meta.url)), '..', 'template-library')
+    const templateDir = join(templatesPath, templateName)
+
+    if (!_fs.existsSync(templateDir)) {
+      console.error(`Error: Template '${templateName}' not found.`)
+      process.exit(1)
+    }
+
+    console.log(`Template: ${templateName}`)
+    const templateJsonPath = join(templateDir, 'template.json')
+    if (_fs.existsSync(templateJsonPath)) {
+      const templateJson = JSON.parse(_fs.readFileSync(templateJsonPath, 'utf-8'))
+      console.log('Configuration:', JSON.stringify(templateJson, null, 2))
+    }
+
+    const readmePath = join(templateDir, 'README.md')
+    if (_fs.existsSync(readmePath)) {
+      console.log('\n--- README ---')
+      console.log(_fs.readFileSync(readmePath, 'utf-8'))
+    }
+    process.exit(0)
   } else {
     // If no specific flags are provided by the user, run main
     main({})

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@involvex/create-wizard",`
`3`		`- "version": "4.0.0",`
	`3`	`+ "version": "4.0.1",`
`4`	`4`	`"description": "create everything with ease interactive ",`
`5`	`5`	`"keywords": [`
`6`	`6`	`"cli",`