npm - forceios - Versions diffs - 13.0.2 → 13.2.0-alpha.0 - Mend

forceios 13.0.2 → 13.2.0-alpha.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/README.md +27 -7
package/package.json +1 -1
package/shared/configHelper.js +115 -50
package/shared/constants.js +118 -17
package/shared/createHelper.js +172 -40
package/shared/jsonChecker.js +2 -1
package/shared/oclifAdapter.js +87 -18
package/shared/templateHelper.js +272 -6

package/README.md CHANGED Viewed

@@ -39,21 +39,46 @@ forceios create
     --packagename=app package identifier (e.g. com.mycompany.myapp)
     --organization=organization name (your company's/organization's name)
     [--outputdir=output directory (leave empty for current directory)]
+    [--consumerkey=OAuth consumer key for the Salesforce External Client App or Connected App]
+    [--callbackurl=OAuth callback URL for the Salesforce External Client App or Connected App]
+    [--loginserver=Login server URL for the Salesforce org]
  OR
 # create an iOS native mobile application from a template
 forceios createwithtemplate
-    --templaterepouri=template repo URI or Mobile SDK template name
+    [--templatesource=git repo URL (optionally with #branch) or local path to a templates suite (root must contain templates.json)]
+    [--templaterepouri=template repo URI or Mobile SDK template name]
+    [--template=template name within the templates suite (e.g. ReactNativeTemplate)]
     --appname=application name
     --packagename=app package identifier (e.g. com.mycompany.myapp)
     --organization=organization name (your company's/organization's name)
     [--outputdir=output directory (leave empty for current directory)]
+    [--consumerkey=OAuth consumer key for the Salesforce External Client App or Connected App]
+    [--callbackurl=OAuth callback URL for the Salesforce External Client App or Connected App]
+    [--loginserver=Login server URL for the Salesforce org]
  OR
-# list available Mobile SDK templates
+# show version of Mobile SDK
+forceios version
+ OR
+# list available Mobile SDK templates to create an iOS native mobile application
 forceios listtemplates
+    [--templatesource=git repo URL (optionally with #branch) or local path to a templates suite (root must contain templates.json)]
+    [--doc=include verbose documentation from template.json files]
+    [--json=output response in JSON format]
+ OR
+# list details for a specific Mobile SDK template to create an iOS native mobile application
+forceios describetemplate
+    [--templatesource=git repo URL (optionally with #branch) or local path to a templates suite (root must contain templates.json)]
+    [--template=template name within the templates suite (e.g. ReactNativeTemplate)]
+    [--doc=include verbose documentation from template.json files]
+    [--json=output response in JSON format]
  OR
@@ -64,11 +89,6 @@ forceios checkconfig
  OR
-# show version of Mobile SDK
-forceios version
- OR
 forceios
 ```

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
     "name": "forceios",
-    "version": "13.0.2",
+    "version": "13.2.0-alpha.0",
     "description": "Utilities for creating mobile apps based on the Salesforce Mobile SDK for iOS",
     "keywords": [ "mobilesdk", "ios", "salesforce", "mobile", "sdk" ],
     "homepage": "https://github.com/forcedotcom/SalesforceMobileSDK-iOS",

package/shared/configHelper.js CHANGED Viewed

@@ -32,33 +32,37 @@ var path = require('path'),
     COLOR = require('./outputColors'),
     commandLineUtils = require('./commandLineUtils'),
     logInfo = require('./utils').logInfo,
+    separateRepoUrlPathBranch = require('./utils').separateRepoUrlPathBranch,
     getTemplates = require('./templateHelper').getTemplates,
+    getTemplate = require('./templateHelper').getTemplate,
+    displayTemplateList = require('./templateHelper').displayTemplateList,
+    displayTemplateDetail = require('./templateHelper').displayTemplateDetail,
     validateJson = require('./jsonChecker').validateJson;
 function applyCli(f, cli) {
-    return typeof f === 'function' ? f(cli): f;
+    return typeof f === 'function' ? f(cli) : f;
 }
 function getArgsExpanded(cli, commandName) {
     var argNames = applyCli(SDK.commands[commandName].args, cli);
     return argNames
         .map(argName => SDK.args[argName])
-        .map(arg =>
-             ({
-                 name: arg.name,
-                 'char': arg.char,
-                 description: applyCli(arg.description, cli),
-                 longDescription: applyCli(arg.longDescription, cli),
-                 prompt: applyCli(arg.prompt, cli),
-                 error: applyCli(arg.error, cli),
-                 validate: applyCli(arg.validate, cli),
-                 promptIf: arg.promptIf,
-                 required: arg.required === undefined ? true : arg.required,
-                 hasValue: arg.hasValue === undefined ? true : arg.hasValue,
-                 hidden: applyCli(arg.hidden, cli),
-                 type: arg.type
-             })
-            );
+        .map(arg =>
+            ({
+                name: arg.name,
+                'char': arg.char,
+                description: applyCli(arg.description, cli),
+                longDescription: applyCli(arg.longDescription, cli),
+                prompt: applyCli(arg.prompt, cli),
+                error: applyCli(arg.error, cli),
+                validate: applyCli(arg.validate, cli),
+                promptIf: arg.promptIf,
+                required: arg.required === undefined ? true : arg.required,
+                hasValue: arg.hasValue === undefined ? true : arg.hasValue,
+                hidden: applyCli(arg.hidden, cli),
+                type: arg.type
+            })
+        );
 }
@@ -69,7 +73,8 @@ function getCommandExpanded(cli, commandName) {
         args: getArgsExpanded(cli, commandName),
         description: applyCli(command.description, cli),
         longDescription: applyCli(command.longDescription, cli),
-        help: applyCli(command.help, cli)
+        help: applyCli(command.help, cli),
+        supportCustomFlags: command.supportCustomFlags
     };
 }
@@ -81,28 +86,32 @@ function readConfig(args, cli, handler) {
     var processorList = null;
     switch (commandName || '') {
-    case SDK.commands.version.name:
-        printVersion(cli);
-        process.exit(0);
-        break;
-    case SDK.commands.create.name:
-    case SDK.commands.createwithtemplate.name:
-        processorList = buildArgsProcessorList(cli, commandName);
-        commandLineUtils.processArgsInteractive(commandLineArgs, processorList, handler);
-        break;
-    case SDK.commands.checkconfig.name:
-        processorList = buildArgsProcessorList(cli, commandName);
-        commandLineUtils.processArgsInteractive(commandLineArgs, processorList, function (config) {
-            validateJson(config.configpath, config.configtype);
-        });
-        break;
-    case SDK.commands.listtemplates.name:
-        listTemplates(cli);
-        process.exit(0);
-        break;
-    default:
-        usage(cli);
-        process.exit(1);
+        case SDK.commands.version.name:
+            printVersion(cli);
+            process.exit(0);
+            break;
+        case SDK.commands.create.name:
+        case SDK.commands.createwithtemplate.name:
+            processorList = buildArgsProcessorList(cli, commandName);
+            commandLineUtils.processArgsInteractive(commandLineArgs, processorList, handler);
+            break;
+        case SDK.commands.checkconfig.name:
+            processorList = buildArgsProcessorList(cli, commandName);
+            commandLineUtils.processArgsInteractive(commandLineArgs, processorList, function (config) {
+                validateJson(config.configpath, config.configtype);
+            });
+            break;
+        case SDK.commands.listtemplates.name:
+            listTemplates(cli, commandLineArgs);
+            process.exit(0);
+            break;
+        case SDK.commands.describetemplate.name:
+            describeTemplate(cli, commandLineArgs);
+            process.exit(0);
+            break;
+        default:
+            usage(cli);
+            process.exit(1);
     };
@@ -115,20 +124,76 @@ function printVersion(cli) {
 function printArgs(cli, commandName) {
     getArgsExpanded(cli, commandName)
         .filter(arg => !arg.hidden)
-        .forEach(arg => logInfo('    ' + (!arg.required  ? '[' : '') + '--' + arg.name + '=' + arg.description + (!arg.required ? ']' : ''), COLOR.magenta));
+        .forEach(arg => logInfo('    ' + (!arg.required ? '[' : '') + '--' + arg.name + '=' + arg.description + (!arg.required ? ']' : ''), COLOR.magenta));
+}
+function listTemplates(cli, commandLineArgs) {
+    var cliName = cli.name;
+    // Parse command line arguments to extract templatesource or templaterepouri
+    var templateSource = null;
+    var templateRepoUri = null;
+    var includeDescriptions = false;
+    var outputJson = false;
+    if (commandLineArgs && commandLineArgs.length > 0) {
+        try {
+            var argsMap = commandLineUtils.parseArgs(commandLineArgs);
+            templateSource = argsMap[SDK.args.templateSource.name];
+            templateRepoUri = argsMap[SDK.args.templateRepoUri.name];
+            includeDescriptions = argsMap.hasOwnProperty(SDK.args.doc.name);
+            outputJson = argsMap.hasOwnProperty(SDK.args.json.name);
+        } catch (error) {
+            // If argument parsing fails, continue without templateRepoUri
+        }
+    }
+    var source = templateSource || templateRepoUri;
+    var applicableTemplates = getTemplates(cli, source, includeDescriptions);
+    // Use shared display function
+    var commandPrefix = cliName + ' ' + SDK.commands.createwithtemplate.name;
+    displayTemplateList(applicableTemplates, source, cliName, commandPrefix, includeDescriptions, null, outputJson);
 }
-function listTemplates(cli) {
+function describeTemplate(cli, commandLineArgs) {
     var cliName = cli.name;
-    var applicableTemplates = getTemplates(cli);
-    logInfo('\nAvailable templates:\n', COLOR.cyan);
-    for (var i=0; i<applicableTemplates.length; i++) {
-        var template = applicableTemplates[i];
-        logInfo((i+1) + ') ' + template.description, COLOR.cyan);
-        logInfo(cliName + ' ' + SDK.commands.createwithtemplate.name + ' --' + SDK.args.templateRepoUri.name + '=' + template.path, COLOR.magenta);
+    // Parse command line arguments to extract templatesource, template, and doc
+    var templateSource = null;
+    var templateRepoUri = null;
+    var templateName = null;
+    var includeDescriptions = false;
+    var outputJson = false;
+    if (commandLineArgs && commandLineArgs.length > 0) {
+        try {
+            var argsMap = commandLineUtils.parseArgs(commandLineArgs);
+            templateSource = argsMap[SDK.args.templateSource.name];
+            templateRepoUri = argsMap[SDK.args.templateRepoUri.name];
+            templateName = argsMap[SDK.args.template.name];
+            includeDescriptions = argsMap.hasOwnProperty(SDK.args.doc.name);
+            outputJson = argsMap.hasOwnProperty(SDK.args.json.name);
+        } catch (error) {
+            // If argument parsing fails, continue without templateRepoUri
+        }
     }
-    logInfo('');
+    // Check if template name is provided
+    if (!templateName) {
+        logInfo('Error: Template name is required. Use --template to specify the template name.', COLOR.red);
+        process.exit(1);
+    }
+    var source = templateSource || templateRepoUri;
+    var template = getTemplate(templateName, source, includeDescriptions);
+    if (!template) {
+        logInfo('Error: Template "' + templateName + '" not found.', COLOR.red);
+        process.exit(1);
+    }
+    // Use shared display function
+    var commandPrefix = cliName + ' ' + SDK.commands.createwithtemplate.name;
+    displayTemplateDetail(template, source, cliName, commandPrefix, includeDescriptions, null, outputJson);
 }
 function usage(cli) {
@@ -184,7 +249,7 @@ function buildArgsProcessorList(cli, commandName) {
 // * preprocessor: function or null
 //
 function addProcessorFor(argProcessorList, argName, prompt, error, validation, preprocessor) {
-    argProcessorList.addArgProcessor(argName, prompt, function(val) {
+    argProcessorList.addArgProcessor(argName, prompt, function (val) {
         val = val.trim();
         // validation is either a function or null

package/shared/constants.js CHANGED Viewed

@@ -28,7 +28,7 @@
 var path = require('path'),
     shelljs = require('shelljs');
-var VERSION= '13.0.2';
+var VERSION= '13.2.0-alpha.0';
 module.exports = {
     version: VERSION,
@@ -60,12 +60,12 @@ module.exports = {
         },
         cordova: {
             checkCmd: 'cordova -v',
-//            pluginRepoUri: 'https://github.com/forcedotcom/SalesforceMobileSDK-CordovaPlugin#dev',    // dev
+            pluginRepoUri: 'https://github.com/forcedotcom/SalesforceMobileSDK-CordovaPlugin#dev',    // dev
             minVersion: '12.0.0',
-             pluginRepoUri: 'salesforce-mobilesdk-cordova-plugin@v' + VERSION, // GA
+//             pluginRepoUri: 'salesforce-mobilesdk-cordova-plugin@v' + VERSION, // GA
             platformVersion: {
                 ios: '7.1.1',
-                android: '13.0.0'
+                android: '14.0.1'
             }
         },
         sf: {
@@ -79,8 +79,8 @@ module.exports = {
         android: 'Android Studio'
     },
-//    templatesRepoUri: 'https://github.com/forcedotcom/SalesforceMobileSDK-Templates#dev',    // dev
-     templatesRepoUri: 'https://github.com/forcedotcom/SalesforceMobileSDK-Templates#v' + VERSION, // GA
+    templatesRepoUri: 'https://github.com/forcedotcom/SalesforceMobileSDK-Templates#dev',    // dev
+//     templatesRepoUri: 'https://github.com/forcedotcom/SalesforceMobileSDK-Templates#v' + VERSION, // GA
     forceclis: {
         forceios: {
@@ -95,7 +95,7 @@ module.exports = {
                 'native': 'iOSNativeTemplate',
                 'native_swift': 'iOSNativeSwiftTemplate'
             },
-            commands: ['create', 'createwithtemplate', 'version', 'listtemplates', 'checkconfig']
+            commands: ['create', 'createwithtemplate', 'version', 'listtemplates', 'describetemplate', 'checkconfig']
         },
         forcedroid: {
             name: 'forcedroid',
@@ -109,7 +109,7 @@ module.exports = {
                 'native': 'AndroidNativeTemplate',
                 'native_kotlin': 'AndroidNativeKotlinTemplate'
             },
-            commands: ['create', 'createwithtemplate', 'version', 'listtemplates', 'checkconfig']
+            commands: ['create', 'createwithtemplate', 'version', 'listtemplates', 'describetemplate', 'checkconfig']
         },
         forcehybrid: {
             name: 'forcehybrid',
@@ -123,7 +123,7 @@ module.exports = {
                 'hybrid_local': 'HybridLocalTemplate',
                 'hybrid_remote': 'HybridRemoteTemplate'
             },
-            commands: ['create', 'createwithtemplate', 'version', 'listtemplates', 'checkconfig']
+            commands: ['create', 'createwithtemplate', 'version', 'listtemplates', 'describetemplate', 'checkconfig']
         },
         forcereact: {
             name: 'forcereact',
@@ -137,10 +137,10 @@ module.exports = {
                 'react_native': 'ReactNativeTemplate',
                 'react_native_typescript': 'ReactNativeTypeScriptTemplate'
             },
-            commands: ['create', 'createwithtemplate', 'version', 'listtemplates', 'checkconfig']
+            commands: ['create', 'createwithtemplate', 'version', 'listtemplates', 'describetemplate', 'checkconfig']
         }
     },
     args: {
         platform: {
             name: 'platform',
@@ -171,6 +171,34 @@ module.exports = {
             prompt: 'Enter URI of repo containing template application or a Mobile SDK template name:',
             error: cli => val => 'Invalid value for template repo uri: \'' + val + '\'.',
             validate: cli => val => /^\S+$/.test(val),
+            promptIf: otherArgs => !otherArgs.templatesource,
+            required: false,
+            type: 'string'
+        },
+        templateSource: {
+            name: 'templatesource',
+            'char': 'S',
+            description: 'git repo URL (optionally with #branch) or local path to a templates suite (root must contain templates.json)',
+            longDescription: 'Location of a suite of templates. Can be a git URL with optional #branch suffix or a local filesystem path whose root contains templates.json.',
+            prompt: 'Enter git URL or local path to your templates suite:',
+            error: cli => val => 'Invalid value for template source: \'' + val + '\'.',
+            validate: cli => val => /\S+/.test(val),
+            // Process only when explicitly provided to avoid prompting during interactive flows
+            promptIf: otherArgs => typeof otherArgs.templatesource !== 'undefined',
+            required: false,
+            type: 'string'
+        },
+        template: {
+            name: 'template',
+            'char': 'm',
+            description: 'template name within the templates suite (e.g. ReactNativeTemplate)',
+            longDescription: 'Name of the template to use from the suite specified by --templatesource. Should match the directory name or the path field in templates.json.',
+            prompt: 'Enter the template name from your template source:',
+            error: cli => val => 'Invalid value for template: \'' + val + '\'.',
+            validate: cli => val => /\S+/.test(val),
+            // Only prompt for template when a templatesource is provided
+            promptIf: otherArgs => !!otherArgs.templatesource,
+            required: false,
             type: 'string'
         },
         appName: {
@@ -268,7 +296,7 @@ module.exports = {
             type: 'string',
             hidden: true
         },
-	sdkDependencies: {
+	    sdkDependencies: {
             name: 'sdkdependencies',
             description: 'override sdk dependencies',
             'char': 'd',
@@ -277,7 +305,64 @@ module.exports = {
             required: false,
             type: 'string',
             hidden: true
-	},
+	        },
+        doc: {
+            name: 'doc',
+            'char': 'D',
+            description: 'include verbose documentation from template.json files',
+            longDescription: 'When specified, includes detailed metadata from each template\'s template.json file if available (displayName, description, useCase, features, complexity).',
+            prompt: null,
+            error: cli => val => 'Invalid value for doc flag: \'' + val + '\'.',
+            validate: cli => val => true, // Boolean flag, no validation needed
+            required: false,
+            type: 'boolean',
+            hidden: false
+        },
+        json: {
+            name: 'json',
+            'char': 'j',
+            description: 'output response in JSON format',
+            longDescription: 'When specified, outputs the response in JSON format instead of human-readable text. Useful for programmatic consumption.',
+            prompt: null,
+            error: cli => val => 'Invalid value for json flag: \'' + val + '\'.',
+            validate: cli => val => true, // Boolean flag, no validation needed
+            required: false,
+            type: 'boolean',
+            hidden: false
+        },
+        consumerKey: {
+            name: 'consumerkey',
+            'char': 'c',
+            description: 'OAuth consumer key for the Salesforce External Client App or Connected App',
+            longDescription: 'The OAuth consumer key (client ID) for your Salesforce External Client App or Connected App. When provided, this will be automatically configured in the generated app.',
+            prompt: 'Enter your OAuth consumer key (leave empty to manually configure this value in the project\'s bootconfig file):',
+            error: cli => val => 'Invalid value for consumer key: \'' + val + '\'.',
+            validate: cli => val => val === undefined || val === '' || /\S+/.test(val),
+            required: false,
+            type: 'string'
+        },
+        callbackURL: {
+            name: 'callbackurl',
+            'char': 'u',
+            description: 'OAuth callback URL for the Salesforce External Client App or Connected App',
+            longDescription: 'The OAuth callback URL (redirect URI) for your Salesforce External Client App or Connected App. When provided, this will be automatically configured in the generated app.',
+            prompt: 'Enter your OAuth callback URL (leave empty to manually configure this value in the project\'s bootconfig file):',
+            error: cli => val => 'Invalid value for callback URL: \'' + val + '\'.',
+            validate: cli => val => val === undefined || val === '' || /\S+/.test(val),
+            required: false,
+            type: 'string'
+        },
+        loginServer: {
+            name: 'loginserver',
+            'char': 'l',
+            description: 'Login server URL for the Salesforce org',
+            longDescription: 'The login server URL for your Salesforce org (e.g. https://login.salesforce.com, https://test.salesforce.com, or custom domain). When provided, this will be automatically configured in the generated app.',
+            prompt: 'Enter your login server URL (leave empty for https://login.salesforce.com):',
+            error: cli => val => 'Invalid value for login server: \'' + val + '\'.',
+            validate: cli => val => val === undefined || val === '' || /\S+/.test(val),
+            required: false,
+            type: 'string'
+        }
     },
     commands: {
@@ -290,6 +375,9 @@ module.exports = {
                           'organization',
                           cli.appTypes.indexOf('hybrid_remote') >=0 ? 'startPage' : null,
                           'outputDir',
+                          'consumerKey',
+                          'callbackURL',
+                          'loginServer',
                           'verbose',
                           cli.name === 'forcehybrid' ? 'pluginRepoUri' : null,
 			  'sdkDependencies'
@@ -301,19 +389,25 @@ module.exports = {
         createwithtemplate: {
             name: 'createwithtemplate',
             args: cli => [cli.platforms.length > 1 ? 'platform' : null,
+                          'templateSource',
                           'templateRepoUri',
+                          'template',
                           'appName',
                           'packageName',
                           'organization',
                           cli.appTypes.indexOf('hybrid_remote') >=0 ? 'startPage' : null,
                           'outputDir',
+                          'consumerKey',
+                          'callbackURL',
+                          'loginServer',
                           'verbose',
                           cli.name === 'forcehybrid' ? 'pluginRepoUri' : null,
-			  'sdkDependencies'
+                          'sdkDependencies'
                          ].filter(x=>x!=null),
             description: cli => 'create ' + cli.purpose + ' from a template',
             longDescription: cli => 'Create ' + cli.purpose + ' from a template.',
-            help: 'This command initiates creation of a new app based on the Mobile SDK template that you specify. The template can be a specialized app for your app type that Mobile SDK provides, or your own custom app that you\'ve configured to use as a template. See https://developer.salesforce.com/docs/atlas.en-us.mobile_sdk.meta/mobile_sdk/ios_new_project_template.htm for information on custom templates.'
+            help: 'This command initiates creation of a new app based on the Mobile SDK template that you specify. The template can be a specialized app for your app type that Mobile SDK provides, or your own custom app that you\'ve configured to use as a template. See https://developer.salesforce.com/docs/atlas.en-us.mobile_sdk.meta/mobile_sdk/ios_new_project_template.htm for information on custom templates.',
+            supportCustomFlags: true
         },
         version: {
             name: 'version',
@@ -324,10 +418,17 @@ module.exports = {
         },
         listtemplates: {
             name: 'listtemplates',
-            args: [],
+            args: ['templateSource', 'doc', 'json'],
             description: cli => 'list available Mobile SDK templates to create ' + cli.purpose,
             longDescription: cli => 'List available Mobile SDK templates to create ' + cli.purpose + '.',
-            help: 'This command displays the list of available Mobile SDK templates. You can copy repo paths from the output for use with the createwithtemplate command.'
+            help: 'This command displays the list of available Mobile SDK templates. You can copy repo paths from the output for use with the createwithtemplate command. Use --templatesource to specify a custom template repository or leave blank to use the default template repository. Use --doc to include detailed metadata from template.json files (displayName, description, useCase, features, complexity). Use --json to output the response in JSON format.'
+        },
+        describetemplate: {
+            name: 'describetemplate',
+            args: ['templateSource', 'template', 'doc', 'json'],
+            description: cli => 'list details for a specific Mobile SDK template to create ' + cli.purpose,
+            longDescription: cli => 'List details for a specific Mobile SDK template to create ' + cli.purpose + '.',
+            help: 'This command displays detailed information about a specific Mobile SDK template. Use --templatesource to specify a custom template repository or leave blank to use the default template repository. Use --template to specify the template name. Use --doc to include verbose metadata from template.json files. Use --json to output the response in JSON format.'
         },
         checkconfig: {
             name: 'checkconfig',

package/shared/createHelper.js CHANGED Viewed

@@ -32,7 +32,11 @@ var path = require('path'),
     configHelper = require('./configHelper'),
     prepareTemplate = require('./templateHelper').prepareTemplate,
     getSDKTemplateURI = require('./templateHelper').getSDKTemplateURI,
-    fs = require('fs');
+    fs = require('fs'),
+    Ajv = require('ajv'),
+    COLOR = require('./outputColors'),
+    readJsonFile = require('./jsonChecker').readJsonFile,
+    JSON5 = require('json5');
 // Constant
 var SERVER_PROJECT_DIR = 'server';
@@ -109,85 +113,150 @@ function createHybridApp(config) {
     // Run cordova prepare
     utils.runProcessThrowError('cordova prepare', config.projectDir);
+    // Add theme for Android API 35
+    if (config.platform.split(',').includes('android')) {
+        createAndroidAPI35Theme(config.projectDir);
+    }
     // Done
     return prepareResult;
 }
+//
+// Add Android API 35 theme file
+//
+function createAndroidAPI35Theme(projectDir) {
+    const dirPath = path.join(projectDir, 'platforms', 'android', 'app', 'src', 'main', 'res', 'values-v35');
+    const filePath = path.join(dirPath, 'themes.xml');
+    const fileContents = `<?xml version='1.0' encoding='utf-8'?>
+<resources>
+    <!-- Override for API 35+ to fix white status bar with white icons issue -->
+    <style name="SalesforceSDK_SplashScreen" parent="Theme.SplashScreen.IconBackground">
+        <item name="postSplashScreenTheme">@style/Theme.AppCompat.NoActionBar</item>
+        <!-- Use dark icons on light status bar background -->
+        <item name="android:windowLightStatusBar">true</item>
+    </style>
+</resources>`
+    // Ensure the directory exists
+    utils.mkDirIfNeeded(dirPath);
+    // Write the file
+    fs.writeFileSync(filePath, fileContents, 'utf8');
+}
 //
 // Print details
 //
 function printDetails(config) {
     // Printing out details
     var details = ['Creating ' + config.platform.replace(',', ' and ') + ' ' + config.apptype + ' application using Salesforce Mobile SDK',
-                        '  with app name:        ' + config.appname,
-                        '       package name:    ' + config.packagename,
-                        '       organization:    ' + config.organization,
+                        '  with app name:         ' + config.appname,
+                        '       package name:     ' + config.packagename,
+                        '       organization:     ' + config.organization,
                         '',
-                        '  in:                   ' + config.projectPath,
+                        '  in:                    ' + config.projectPath,
                         '',
-                        '  from template repo:   ' + config.templaterepouri
+                        '  from template repo:    ' + config.templaterepouri
                   ];
     if (config.templatepath) {
-        details = details.concat(['       template path:   ' + config.templatepath]);
+        details = details.concat(['       template path:    ' + config.templatepath]);
     }
     if (config.sdkdependencies) {
-        details = details.concat(['       sdk dependencies:   ' + config.sdkdependencies]);
+        details = details.concat(['       sdk dependencies: ' + config.sdkdependencies]);
+    }
+    // OAuth configuration details
+    if (config.consumerkey && config.consumerkey !== '__INSERT_CONSUMER_KEY_HERE__' && config.consumerkey.trim() !== '') {
+        details = details.concat(['       consumer key:     ' + config.consumerkey]);
+    }
+    if (config.callbackurl && config.callbackurl !== '__INSERT_CALLBACK_URL_HERE__' && config.callbackurl.trim() !== '') {
+        details = details.concat(['       callback URL:     ' + config.callbackurl]);
+    }
+    if (config.loginserver && config.loginserver.trim() !== '') {
+        details = details.concat(['       login server:     ' + config.loginserver]);
     }
     // Hybrid extra details
     if (config.apptype.indexOf('hybrid') >= 0) {
         if (config.apptype === 'hybrid_remote') {
-            details = details.concat(['       start page:      ' + config.startpage]);
+            details = details.concat(['       start page:       ' + config.startpage]);
         }
-        details = details.concat(['       plugin repo:     ' + config.cordovaPluginRepoUri]);
+        details = details.concat(['       plugin repo:      ' + config.cordovaPluginRepoUri]);
     }
     utils.logParagraph(details);
 }
+//
+// Check if valid OAuth configuration is provided
+//
+function hasValidOAuthConfig(config) {
+    return config.consumerkey && config.callbackurl &&
+           config.consumerkey !== '__INSERT_CONSUMER_KEY_HERE__' &&
+           config.callbackurl !== '__INSERT_CALLBACK_URL_HERE__' &&
+           config.consumerkey.trim() !== '' &&
+           config.callbackurl.trim() !== '' &&
+           (!config.loginserver || config.loginserver.trim() !== '');
+}
 //
 // Print next steps
 //
-function printNextSteps(ide, projectPath, result) {
+function printNextSteps(ide, projectPath, result, hasValidOAuth) {
     var workspacePath = path.join(projectPath, result.workspacePath);
     var bootconfigFile =  path.join(projectPath, result.bootconfigFile);
+    var nextSteps = ['Next steps' + (result.platform ? ' for ' + result.platform : '') + ':',
+                     '',
+                     'Your application project is ready in ' + projectPath + '.',
+                     'To use your new application in ' + ide + ', do the following:',
+                     '   - open ' + workspacePath + ' in ' + ide];
+    // Only show OAuth configuration instructions if valid OAuth config was not provided
+    if (!hasValidOAuth) {
+        nextSteps.push('   - make sure to plug your OAuth Client ID and Callback URI');
+        nextSteps.push('     into ' + bootconfigFile);
+    }
+    nextSteps.push('   - build and run');
     // Printing out next steps
-    utils.logParagraph(['Next steps' + (result.platform ? ' for ' + result.platform : '') + ':',
-                        '',
-                        'Your application project is ready in ' + projectPath + '.',
-                        'To use your new application in ' + ide + ', do the following:',
-                        '   - open ' + workspacePath + ' in ' + ide,
-                        '   - build and run',
-                        'Before you ship, make sure to plug your OAuth Client ID and Callback URI,',
-                        'and OAuth Scopes into ' + bootconfigFile,
-                       ]);
+    utils.logParagraph(nextSteps);
 };
 //
 // Print next steps for Native Login
 //
-function printNextStepsForNativeLogin(ide, projectPath, result) {
+function printNextStepsForNativeLogin(ide, projectPath, result, hasValidOAuth) {
     var workspacePath = path.join(projectPath, result.workspacePath);
     var bootconfigFile =  path.join(projectPath, result.bootconfigFile);
     var entryFile = (ide === 'XCode') ? 'SceneDelegate' : 'MainApplication';
+    var nextSteps = ['Next steps' + (result.platform ? ' for ' + result.platform : '') + ':',
+                     '',
+                     'Your application project is ready in ' + projectPath + '.',
+                     'To use your new application in ' + ide + ', do the following:',
+                     '   - open ' + workspacePath + ' in ' + ide];
+    // Only show OAuth configuration instructions if valid OAuth config was not provided
+    if (!hasValidOAuth) {
+        nextSteps.push('   - Update the OAuth Client ID, Callback URI, and Community URL in ' + entryFile + ' class.');
+        nextSteps.push('   - Make sure to plug your OAuth Client ID and Callback URI into');
+        nextSteps.push('     into ' + bootconfigFile);
+        nextSteps.push('     since it is still be used for authentication if we fallback on the webview.');
+    }
+    nextSteps.push('   - build and run');
     // Printing out next steps
-    utils.logParagraph(['Next steps' + (result.platform ? ' for ' + result.platform : '') + ':',
-                        '',
-                        'Your application project is ready in ' + projectPath + '.',
-                        'To use your new application in ' + ide + ', do the following:',
-                        '   - open ' + workspacePath + ' in ' + ide,
-                        '   - Update the OAuth Client ID, Callback URI, and Community URL in ' + entryFile + ' class.',
-                        '   - build and run',
-                        'Before you ship, make sure to plug your OAuth Client ID and Callback URI,',
-                        'and OAuth Scopes into ' + bootconfigFile + ', since it is still used for',
-                        'authentication if we fallback on the webview.'
-                       ]);
+    utils.logParagraph(nextSteps);
 }
 //
@@ -324,13 +393,41 @@ function actuallyCreateApp(forcecli, config) {
         config.version = SDK.version;
         // Figuring out template repo uri and path
-        if (config.templaterepouri) {
-            if (!config.templaterepouri.startsWith("https://")) {
+        let localTemplatesRoot;
+        if (config.templatesource) {
+            const source = config.templatesource;
+            if (fs.existsSync(source)) {
+                // Local path to templates suite
+                localTemplatesRoot = path.resolve(source);
+                if (!config.template) {
+                    throw new Error('Missing --template when using --templatesource pointing to a local path');
+                }
+                config.templatepath = config.template;
+                // For display purposes
+                config.templaterepouri = source;
+            } else {
+                // Git URL with optional #branch
+                const parsed = utils.separateRepoUrlPathBranch(source);
+                config.templaterepouri = parsed.repo + '#' + parsed.branch;
+                config.templatepath = config.template || parsed.path;
+                if (!config.templatepath) {
+                    throw new Error('Missing template name. Use --template to specify a template within your --templatesource repository.');
+                }
+            }
+        }
+        else if (config.templaterepouri) {
+            if (fs.existsSync(config.templaterepouri)) {
+                // Local path directly to a specific template directory
+                localTemplatesRoot = path.resolve(config.templaterepouri);
+                config.templaterepouri = localTemplatesRoot;
+                // Use the directory itself as the template root
+                config.templatepath = '';
+            } else if (!config.templaterepouri.startsWith("https://")) {
                 // Given a Mobile SDK template name
                 config.templatepath = config.templaterepouri;
                 config.templaterepouri = SDK.templatesRepoUri;
             } else {
-                // Given a full URI
+                // Given a full URI to a specific template path
                 var templateUriParsed = utils.separateRepoUrlPathBranch(config.templaterepouri);
                 config.templaterepouri = templateUriParsed.repo + '#' + templateUriParsed.branch;
                 config.templatepath = templateUriParsed.path;
@@ -344,10 +441,17 @@ function actuallyCreateApp(forcecli, config) {
         // Creating tmp dir for template clone
         var tmpDir = utils.mkTmpDir();
-        // Cloning template repo
-        var repoDir = utils.cloneRepo(tmpDir, config.templaterepouri);
+        // Resolve template source directory (clone if needed)
+        var repoDir;
+        if (localTemplatesRoot) {
+            repoDir = localTemplatesRoot;
+        } else {
+            repoDir = utils.cloneRepo(tmpDir, config.templaterepouri);
+        }
         config.templateLocalPath = path.join(repoDir, config.templatepath);
+        validateCustomProperties(`${repoDir}/template.json`, config.templateProperties);
         // Override sdk dependencies in package.json if any were provided
         if (config.sdkdependencies) {
             overrideSdkDependencies(path.join(config.templateLocalPath, 'package.json'), config.sdkdependencies);
@@ -374,13 +478,14 @@ function actuallyCreateApp(forcecli, config) {
         // Printing next steps
         if (!(results instanceof Array)) { results = [results] };
+        var hasValidOAuth = hasValidOAuthConfig(config);
         for (var result of results) {
             var ide = SDK.ides[result.platform || config.platform.split(',')[0]];
             if (config.templatepath != undefined && config.templatepath.includes('NativeLogin')) {
-                printNextStepsForNativeLogin(ide, config.projectPath, result);
+                printNextStepsForNativeLogin(ide, config.projectPath, result, hasValidOAuth);
             } else {
-                printNextSteps(ide, config.projectPath, result);
+                printNextSteps(ide, config.projectPath, result, hasValidOAuth);
             }
         }
         printNextStepsForServerProjectIfNeeded(config.projectPath);
@@ -392,6 +497,33 @@ function actuallyCreateApp(forcecli, config) {
     }
 }
+function validateCustomProperties(templateJsonPath, customProperties) {
+    // skip if template json file does not exist
+    if (!fs.existsSync(templateJsonPath)) {
+        return;
+    }
+    utils.log('Validating custom properties against schema...');
+    // Validate data against schema with AJV
+    const ajv = new Ajv({allErrors: true});
+    const schema = readJsonFile(templateJsonPath);
+    const validate = ajv.compile(schema);
+    const jsonToValidate = {
+        templatePrerequisites: { templateProperties: customProperties }
+    }
+    const valid = validate(jsonToValidate);
+    if (!valid) {
+        utils.logError('Custom properties validation failed:\n',
+            JSON.stringify(validate.errors, null, "  "));
+        process.exit(1);
+    }
+    utils.logInfo('Custom properties are valid\n', COLOR.green);
+}
 module.exports = {
-    createApp
+    createApp,
+    validateCustomProperties
 };

package/shared/jsonChecker.js CHANGED Viewed

@@ -71,5 +71,6 @@ function readJsonFile(filePath) {
 }
 module.exports = {
-    validateJson
+    validateJson,
+    readJsonFile
 };

package/shared/oclifAdapter.js CHANGED Viewed

@@ -30,12 +30,14 @@ const SDK = require('./constants');
 const configHelper = require('./configHelper');
 const createHelper = require('./createHelper');
 const templateHelper = require('./templateHelper');
+const { getTemplates, getTemplate, displayTemplateList, displayTemplateDetail } = require('./templateHelper');
 const jsonChecker = require('./jsonChecker');
 const logInfo = require('./utils').logInfo;
 const logError = require('./utils').logError;
+const separateRepoUrlPathBranch = require('./utils').separateRepoUrlPathBranch;
 const os = require('os');
-const { SfdxError } = require('@salesforce/core');
+const { SfError } = require('@salesforce/core');
 const { Command, flags } = require('@oclif/command');
 const namespace = 'mobilesdk';
@@ -46,21 +48,36 @@ class OclifAdapter extends Command {
         return `${description}${os.EOL}${os.EOL}${help}`;
     }
-    static listTemplates(cli) {
-        const applicableTemplates = templateHelper.getTemplates(cli);
+    static listTemplates(cli, templateSourceOrRepoUri, includeDescriptions, outputJson) {
+        const applicableTemplates = getTemplates(cli, templateSourceOrRepoUri, includeDescriptions);
-        logInfo('\nAvailable templates:\n', COLOR.cyan);
-        for (let i=0; i<applicableTemplates.length; i++) {
-            const template = applicableTemplates[i];
-            logInfo((i+1) + ') ' + template.description, COLOR.cyan);
-            logInfo('sfdx ' +  [namespace, cli.topic, SDK.commands.createwithtemplate.name].join(':') + ' --' +
-                SDK.args.templateRepoUri.name + '=' + template.path, COLOR.magenta);
+        // Use shared display function
+        const commandPrefix = 'sf ' + [namespace, cli.topic, SDK.commands.createwithtemplate.name].join(':');
+        const usageExample = '--' + SDK.args.appName.name + '=<YOUR_APP_NAME> --' + SDK.args.packageName.name + '=<YOUR_PACKAGE_NAME> --' + SDK.args.organization.name + '=<YOUR_ORGANIZATION_NAME>';
+        displayTemplateList(applicableTemplates, templateSourceOrRepoUri, cli.name, commandPrefix, includeDescriptions, usageExample, outputJson);
+    }
+    static describeTemplate(cli, templateSourceOrRepoUri, templateName, includeDescriptions, outputJson) {
+        if (!templateName) {
+            logError('Error: Template name is required. Use --template to specify the template name.');
+            process.exit(1);
+        }
+        const template = getTemplate(templateName, templateSourceOrRepoUri, includeDescriptions);
+        if (!template) {
+            logError('Error: Template "' + templateName + '" not found.');
+            process.exit(1);
         }
-        logInfo('');
+        // Use shared display function
+        const commandPrefix = 'sf ' + [namespace, cli.topic, SDK.commands.createwithtemplate.name].join(':');
+        const usageExample = '--' + SDK.args.appName.name + '=<YOUR_APP_NAME> --' + SDK.args.packageName.name + '=<YOUR_PACKAGE_NAME> --' + SDK.args.organization.name + '=<YOUR_ORGANIZATION_NAME>';
+        displayTemplateDetail(template, templateSourceOrRepoUri, cli.name, commandPrefix, includeDescriptions, usageExample, outputJson);
     }
     static runCommand(cli, commandName, vals) {
-        switch(commandName) {
+        switch (commandName) {
             case SDK.commands.create.name:
             case SDK.commands.createwithtemplate.name:
                 createHelper.createApp(cli, vals);
@@ -69,7 +86,11 @@ class OclifAdapter extends Command {
                 configHelper.printVersion(cli);
                 break;
             case SDK.commands.listtemplates.name:
-                OclifAdapter.listTemplates(cli);
+                OclifAdapter.listTemplates(cli, vals.templatesource, vals.doc, vals.json);
+                process.exit(0);
+                break;
+            case SDK.commands.describetemplate.name:
+                OclifAdapter.describeTemplate(cli, vals.templatesource, vals.template, vals.doc, vals.json);
                 process.exit(0);
                 break;
             case SDK.commands.checkconfig.name:
@@ -139,9 +160,15 @@ class OclifAdapter extends Command {
     }
     execute(cli, klass) {
-        const { flags } = this.parse(klass);
-        if (OclifAdapter.validateCommand(cli, klass.command.name, flags)) {
-            return OclifAdapter.runCommand(cli, klass.command.name, flags);
+        const { flags, argv : remainingArgs } = this.parse(klass);
+        const commandConfig = klass.command;
+        if (OclifAdapter.validateCommand(cli, commandConfig.name, flags)) {
+            // If the command supports custom flags and there are remaining arguments, parse the custom properties
+            if (klass.command.supportCustomFlags === true && remainingArgs.length > 0) {
+                const customProperties = OclifAdapter.getCustomProperties(remainingArgs);
+                flags.templateProperties = customProperties;
+            }
+            return OclifAdapter.runCommand(cli, commandConfig.name, flags);
         }
     }
@@ -180,16 +207,58 @@ class OclifAdapter extends Command {
                         this.flags[name] = flag.quantity + '';
                         break;
                     } else {
-                        throw new SfdxError(`Unexpected value type for flag ${name}`, 'UnexpectedFlagValueType');
+                        throw new SfError(`Unexpected value type for flag ${name}`, 'UnexpectedFlagValueType');
                     }
                 default:
-                    throw new SfdxError(`Unexpected value type for flag ${name}`, 'UnexpectedFlagValueType');
+                    throw new SfError(`Unexpected value type for flag ${name}`, 'UnexpectedFlagValueType');
             }
         });
     }
+    static getCustomProperties(args) {
+        const properties = {};
+        const prefix = '--template-property-';
+        for (let i = 0; i < args.length; i++) {
+            const arg = args[i];
+            // Check if this argument starts with --template- but not --template-property-
+            if (arg.startsWith('--template-') && !arg.startsWith(prefix)) {
+                throw new SfError(
+                    `Invalid template property flag: "${arg}". Template properties must be prefixed with "${prefix}".`,
+                    'InvalidTemplatePropertyPrefix'
+                );
+            }
+            // Check if this argument is a template property flag
+            if (arg.startsWith(prefix)) {
+                // Check if the value is provided with equals sign (--template-property-prop1=val1)
+                if (arg.includes('=')) {
+                    const equalIndex = arg.indexOf('=');
+                    const propertyName = arg.substring(prefix.length, equalIndex);
+                    const propertyValue = arg.substring(equalIndex + 1);
+                    properties[propertyName] = propertyValue;
+                } else {
+                    // Extract the property name (everything after the prefix)
+                    const propertyName = arg.substring(prefix.length);
+                    // Check if there's a next argument and it's not another template property flag
+                    if (i + 1 < args.length && !args[i + 1].startsWith('--')) {
+                        // Use the next argument as the value
+                        properties[propertyName] = args[i + 1];
+                        i++; // Skip the value in the next iteration
+                    }
+                    // If the next argument is another flag or doesn't exist, skip this property
+                }
+            }
+        }
+        return properties;
+    }
 }
-OclifAdapter.getCommand = function(cli, commandName) {
+OclifAdapter.getCommand = function (cli, commandName) {
     if (!this._command) {
         this._command = configHelper.getCommandExpanded(cli, commandName);
     }

package/shared/templateHelper.js CHANGED Viewed

@@ -28,7 +28,9 @@
 // Dependencies
 var path = require('path'),
     SDK = require('./constants'),
-    utils = require('./utils');
+    utils = require('./utils'),
+    fs = require('fs'),
+    { constantCase } = require('change-case');
 //
 // Helper to prepare template
@@ -36,7 +38,7 @@ var path = require('path'),
 function prepareTemplate(config, templateDir) {
     var template = require(path.join(templateDir, 'template.js'));
     return utils.runFunctionThrowError(
-        function() {
+        function () {
             return template.prepare(config, utils.replaceInFiles, utils.moveFile, utils.removeFile);
         },
         templateDir);
@@ -45,14 +47,22 @@ function prepareTemplate(config, templateDir) {
 //
 // Get templates for the given cli
 //
-function getTemplates(cli) {
+function getTemplates(cli, templateSourceOrRepoUri, includeDescriptions) {
     try {
         // Creating tmp dir for template clone
         var tmpDir = utils.mkTmpDir();
-        // Cloning template repo
-        var repoDir = utils.cloneRepo(tmpDir, SDK.templatesRepoUri);
+        // Use provided source (git URL or local path) or fall back to default
+        var source = templateSourceOrRepoUri || SDK.templatesRepoUri;
+        var repoDir;
+        if (fs.existsSync(source)) {
+            // Local path
+            repoDir = path.resolve(source);
+        } else {
+            // Git URL
+            repoDir = utils.cloneRepo(tmpDir, source);
+        }
         // Getting list of templates
         var templates = require(path.join(repoDir, 'templates.json'));
@@ -61,6 +71,16 @@ function getTemplates(cli) {
         var applicableTemplates = templates
             .filter(template => cli.appTypes.includes(template.appType) && cli.platforms.filter(platform => template.platforms.includes(platform)).length > 0);
+        // Add metadata and custom properties to each template
+        applicableTemplates.forEach(function (template) {
+            const metadata = getTemplateMetadata(template.path, repoDir);
+            template.customProperties = getCustomProperties(metadata);
+            // If descriptions are requested, add metadata
+            if (includeDescriptions) {
+                template.metadata = metadata;
+            }
+        });
         // Cleanup
         utils.removeFile(tmpDir);
@@ -96,9 +116,255 @@ function getAppTypeFromTemplate(templateRepoUriWithPossiblePath) {
     return appType;
 }
+//
+// Extract template metadata from template.json file
+//
+function getTemplateMetadata(templatePath, repoDir) {
+    try {
+        var templateJsonPath = path.join(repoDir, templatePath, 'template.json');
+        if (fs.existsSync(templateJsonPath)) {
+            var templateJsonContent = fs.readFileSync(templateJsonPath, 'utf8');
+            var templateData = JSON.parse(templateJsonContent);
+            // Return all metadata properties from the template.json file
+            // This makes the function more flexible for future use cases
+            return templateData;
+        }
+    } catch (error) {
+        // If there's any error reading or parsing the template.json, just return null
+        // This ensures the command continues to work even if template.json parsing fails
+    }
+    return null;
+}
+//
+// Get a single template by name
+//
+function getTemplate(templateName, templateSourceOrRepoUri, includeDescriptions) {
+    try {
+        // Creating tmp dir for template clone
+        var tmpDir = utils.mkTmpDir();
+        // Use provided source (git URL or local path) or fall back to default
+        var source = templateSourceOrRepoUri || SDK.templatesRepoUri;
+        var repoDir;
+        if (fs.existsSync(source)) {
+            // Local path
+            repoDir = path.resolve(source);
+        } else {
+            // Git URL
+            repoDir = utils.cloneRepo(tmpDir, source);
+        }
+        // Getting list of templates
+        var templates = require(path.join(repoDir, 'templates.json'));
+        // Finding the specific template
+        var template = templates.find(t => t.path === templateName);
+        if (!template) {
+            utils.removeFile(tmpDir);
+            return null;
+        }
+        const metadata = getTemplateMetadata(template.path, repoDir);
+        template.customProperties = getCustomProperties(metadata);
+        // If descriptions are requested, add metadata
+        if (includeDescriptions) {
+            template.metadata = metadata;
+        }
+        // Cleanup
+        utils.removeFile(tmpDir);
+        return template;
+    } catch (error) {
+        return null;
+    }
+}
+//
+// Build template command string
+//
+function buildTemplateCommand(source, commandPrefix, templatePath, extraRequiredArgs, customProperties) {
+    var sourceForCommand = source || SDK.templatesRepoUri;
+    var command = commandPrefix + ' --' + SDK.args.templateSource.name + '=' + sourceForCommand
+        + ' --' + SDK.args.template.name + '=' + templatePath;
+    if (extraRequiredArgs) {
+        command += ` ${extraRequiredArgs}`;
+    }
+    // Add custom command args if provided
+    if (customProperties) {
+        const customCommandArgs = getCustomCommandArgs(customProperties);
+        if (customCommandArgs.length > 0) {
+            command += ` ${customCommandArgs.join(' ')}`;
+        }
+    }
+    return command;
+}
+//
+// Display template list with optional metadata
+//
+function displayTemplateList(templates, source, cliName, commandPrefix, includeDescriptions, extraRequiredArgs, outputJson) {
+    var COLOR = require('./outputColors');
+    var logInfo = utils.logInfo;
+    if (outputJson) {
+        // Output in JSON format
+        var jsonOutput = {
+            repository: source || 'default',
+            templates: templates.map(function (template, index) {
+                var command = buildTemplateCommand(source, commandPrefix, template.path, extraRequiredArgs, template.customProperties);
+                var jsonTemplate = {
+                    index: index + 1,
+                    path: template.path,
+                    description: template.description,
+                    appType: template.appType,
+                    platforms: template.platforms,
+                    command: command
+                };
+                if (includeDescriptions && template.metadata) {
+                    jsonTemplate.metadata = template.metadata;
+                }
+                return jsonTemplate;
+            })
+        };
+        logInfo(JSON.stringify(jsonOutput, null, 2), COLOR.white);
+        return;
+    }
+    // Show which template repository is being used
+    if (source) {
+        logInfo('\nAvailable templates from custom repository:\n', COLOR.cyan);
+        logInfo('Repository: ' + source, COLOR.cyan);
+    } else {
+        logInfo('\nAvailable templates:\n', COLOR.cyan);
+    }
+    for (var i = 0; i < templates.length; i++) {
+        var template = templates[i];
+        logInfo((i + 1) + ') ' + template.description, COLOR.cyan);
+        var command = buildTemplateCommand(source, commandPrefix, template.path, extraRequiredArgs, template.customProperties);
+        logInfo(command, COLOR.magenta);
+        // If descriptions are requested and available, show them
+        if (includeDescriptions && template.metadata) {
+            if (template.metadata.description) {
+                logInfo('   Description: ' + template.metadata.description, COLOR.white);
+            }
+            if (template.metadata.useCase) {
+                logInfo('   Use Case: ' + template.metadata.useCase, COLOR.white);
+            }
+            if (template.metadata.features && Array.isArray(template.metadata.features)) {
+                logInfo('   Features: ' + template.metadata.features.join(', '), COLOR.white);
+            }
+            if (template.metadata.complexity) {
+                logInfo('   Complexity: ' + template.metadata.complexity, COLOR.white);
+            }
+        }
+    }
+    logInfo('');
+}
+//
+// Display detailed information about a single template
+//
+function displayTemplateDetail(template, source, cliName, commandPrefix, includeDescriptions, extraRequiredArgs, outputJson) {
+    var COLOR = require('./outputColors');
+    var logInfo = utils.logInfo;
+    // create command usage
+    var command = buildTemplateCommand(source, commandPrefix, template.path, extraRequiredArgs, template.customProperties);
+    if (outputJson) {
+        // Output in JSON format
+        var jsonOutput = {
+            repository: source || 'default',
+            template: {
+                path: template.path,
+                description: template.description,
+                appType: template.appType,
+                platforms: template.platforms,
+                command: command
+            }
+        };
+        if (includeDescriptions && template.metadata) {
+            jsonOutput.template.metadata = template.metadata;
+        }
+        logInfo(JSON.stringify(jsonOutput, null, 2), COLOR.white);
+        return;
+    }
+    // Show which template repository is being used
+    if (source) {
+        logInfo('\nTemplate from custom repository:\n', COLOR.cyan);
+        logInfo('Repository: ' + source, COLOR.cyan);
+    } else {
+        logInfo('\nTemplate from default repository:\n', COLOR.cyan);
+    }
+    // Display template basic info
+    logInfo('Template: ' + template.path, COLOR.cyan);
+    logInfo('Description: ' + template.description, COLOR.cyan);
+    logInfo('App Type: ' + template.appType, COLOR.cyan);
+    logInfo('Platforms: ' + template.platforms.join(', '), COLOR.cyan);
+    logInfo('\nUsage:', COLOR.magenta);
+    // Display command usage
+    logInfo(command, COLOR.magenta);
+    // If descriptions are requested and available, show raw JSON metadata
+    if (includeDescriptions && template.metadata) {
+        logInfo('\nTemplate Metadata (template.json):', COLOR.cyan);
+        logInfo(JSON.stringify(template.metadata, null, 2), COLOR.white);
+    }
+    logInfo('');
+}
+/**
+ * Get custom properties from metadata
+ * @param {Object} metadata - Template schema json object
+ * @returns {Object} Custom properties object
+ */
+function getCustomProperties(metadata) {
+    return metadata?.properties?.templatePrerequisites?.properties?.templateProperties || null;
+}
+/**
+ * Get custom command args from custom properties metadata
+ * @param {JSON} customPropertiesMetadata - Custom properties metadata
+ * @returns {Array} Custom command args
+ */
+function getCustomCommandArgs(customPropertiesMetadata) {
+    const properties = customPropertiesMetadata?.properties;
+    if (!properties) {
+        return [];
+    }
+    return Object.keys(properties).map(key => `--template-property-${key}=<${constantCase(key)}>`);
+}
 module.exports = {
     prepareTemplate,
     getTemplates,
-    getAppTypeFromTemplate
+    getTemplate,
+    getAppTypeFromTemplate,
+    getTemplateMetadata,
+    displayTemplateList,
+    displayTemplateDetail,
+    getCustomProperties,
+    getCustomCommandArgs
 };