@commercetools-frontend/create-mc-app 22.2.0 → 22.3.0

package/dist/commercetools-frontend-create-mc-app.esm.js

@@ -33,7 +33,7 @@ import prettier from 'prettier';
 
 var pkgJson = {
 	name: "@commercetools-frontend/create-mc-app",
-	version: "22.2.0",
+	version: "22.3.0",
 	description: "Create Merchant Center applications to quickly get up and running",
 	bugs: "https://github.com/commercetools/merchant-center-application-kit/issues",
 	repository: {
@@ -59,6 +59,8 @@ var pkgJson = {
 		"@babel/core": "^7.20.12",
 		"@babel/runtime": "^7.20.13",
 		"@babel/runtime-corejs3": "^7.20.13",
+		"@types/babel__core": "^7.20.0",
+		"@types/semver": "^7.5.0",
 		cac: "6.7.14",
 		execa: "5.1.1",
 		listr2: "5.0.8",
@@ -83,14 +85,10 @@ async function getLatestReleaseVersion() {
 
 function hintOutdatedVersion(currentVersion, releaseVersion) {
   var _context;
-
   const hasBeenReleastedInLatestTag = semver.gt(releaseVersion, currentVersion);
-
   const hintNewerVersions = _filterInstanceProperty(_context = [hasBeenReleastedInLatestTag && "".concat(releaseVersion)]).call(_context, Boolean).join(', ');
-
   if (hintNewerVersions.length > 0) {
     var _context2;
-
     console.log('');
     console.log(_concatInstanceProperty(_context2 = "New version available! ".concat(currentVersion, " -> ")).call(_context2, hintNewerVersions));
     console.log('');
@@ -98,7 +96,6 @@ function hintOutdatedVersion(currentVersion, releaseVersion) {
 }
 
 const isSemVer = version => /^(v?)([0-9].[0-9].[0-9])+/.test(version);
-
 const shouldUseYarn = () => {
   try {
     const result = execa.commandSync('yarn --version', {
@@ -109,28 +106,30 @@ const shouldUseYarn = () => {
     return false;
   }
 };
-
+const getPreferredPackageManager = options => {
+  if (options.packageManager) {
+    return options.packageManager;
+  }
+  // Attempt to use yarn (backwards compatibility)
+  if (shouldUseYarn()) {
+    return 'yarn';
+  }
+  // Fall back to npm
+  return 'npm';
+};
 const slugify = name => name.toLowerCase().replace(/_/gi, '-');
-
 const upperFirst = value => value.charAt(0).toUpperCase() + _sliceInstanceProperty(value).call(value, 1);
-
 const wordify = slug => {
   var _context;
-
   return _mapInstanceProperty(_context = slug.split('-')).call(_context, word => upperFirst(word)).join(' ');
 };
-
 const resolveFilePathByExtension = requestedModule => {
   var _context2, _context4;
-
   const fileExtension = _findInstanceProperty(_context2 = ['.js', '.ts', '.mjs', '.cjs']).call(_context2, ext => {
     var _context3;
-
     const filePath = _concatInstanceProperty(_context3 = "".concat(requestedModule)).call(_context3, ext);
-
     return fs.existsSync(filePath);
   });
-
   return _concatInstanceProperty(_context4 = "".concat(requestedModule)).call(_context4, fileExtension);
 };
 
@@ -138,112 +137,91 @@ const availableTemplates = {
   starter: 'starter',
   'starter-typescript': 'starter-typescript'
 };
-
 const throwIfTemplateIsNotSupported = templateName => {
   var _context;
-
   switch (templateName) {
     case availableTemplates.starter:
     case availableTemplates['starter-typescript']:
       break;
-
     default:
       const templateNamesList = _Object$keys(availableTemplates).toString();
-
       throw new Error(_concatInstanceProperty(_context = "The provided template name \"".concat(templateName, "\" does not exist. Available templates are \"")).call(_context, templateNamesList, "\". Make sure you are also using the latest version of \"@commercetools-frontend/create-mc-app\"."));
   }
 };
-
 const throwIfProjectDirectoryExists = (dirName, dirPath) => {
   if (fs.existsSync(dirPath)) {
     var _context2;
-
     throw new Error(_concatInstanceProperty(_context2 = "A directory named \"".concat(dirName, "\" already exists at this location \"")).call(_context2, dirPath, "\". Please choose a different project name or remove the directory, then try running the command again."));
   }
 };
-
 const throwIfTemplateVersionDoesNotExist = (templateName, templateFolderPath, versionToCheck) => {
   if (!fs.existsSync(templateFolderPath)) {
     var _context3;
-
     throw new Error(_concatInstanceProperty(_context3 = "The downloaded template \"".concat(templateName, "\" does not exist for the given version \"")).call(_context3, versionToCheck, "\". Check the releases page if you are looking for a specific version: https://github.com/commercetools/merchant-center-application-kit/releases"));
-  } // In case the version is semver (usually release tags) we check that
+  }
+  // In case the version is semver (usually release tags) we check that
   // the cloned repository contains the template matching the given version
-
-
   if (isSemVer(versionToCheck)) {
     const templatePackageJson = JSON.parse(fs.readFileSync(path.join(templateFolderPath, 'package.json'), {
       encoding: 'utf8'
     }));
     const versionAsNumber = versionToCheck.replace('v', '');
-
     if (templatePackageJson.version !== versionAsNumber) {
       var _context4, _context5;
-
       throw new Error(_concatInstanceProperty(_context4 = _concatInstanceProperty(_context5 = "The downloaded template \"".concat(templateName, "\" does not match the version \"")).call(_context5, versionAsNumber, "\", instead got \"")).call(_context4, templatePackageJson.version, "\". Check the releases page if you want to provide a specific version: https://github.com/commercetools/merchant-center-application-kit/releases"));
     }
   }
 };
-
 const throwIfInitialProjectKeyIsMissing = initialProjectKey => {
   if (!initialProjectKey) {
     throw new Error("Provide a valid project key that you have access to.");
   }
 };
-
 const throwIfNodeVersionIsNotSupported = (currentNodeVersion, expectedVersionRange) => {
   const hasValidNodeVersion = semver.satisfies(currentNodeVersion, expectedVersionRange);
-
   if (!hasValidNodeVersion) {
     var _context6;
-
     throw new Error(_concatInstanceProperty(_context6 = "You are running Node ".concat(currentNodeVersion, " but create-mc-app requires Node ")).call(_context6, expectedVersionRange, ". Please update your version of Node."));
   }
 };
 
 const question = (rl, value) => new _Promise(resolve => rl.question(value, resolve));
-
 const getEntryPointUriPath = async (rl, options) => {
   var _context;
-
   if (options.entryPointUriPath) {
     return options.entryPointUriPath;
   }
-
   const randomEntryPointUriPath = _concatInstanceProperty(_context = "".concat(options.template, "-")).call(_context, crypto.randomBytes(3).toString('hex'));
-
   if (options.yes) {
     return randomEntryPointUriPath;
   }
-
   const answerEntryPointUriPath = await question(rl, "Provide the Custom Application entryPointUriPath (default \"".concat(randomEntryPointUriPath, "\"): "));
   return answerEntryPointUriPath || randomEntryPointUriPath;
 };
-
 const getInitialProjectKey = async (rl, options) => {
   if (options.initialProjectKey) {
     return options.initialProjectKey;
   }
-
   const initialProjectKey = await question(rl, "Provide the initial project key for local development: ");
   throwIfInitialProjectKeyIsMissing(initialProjectKey);
   return initialProjectKey;
 };
-
 async function processOptions(projectDirectoryName, options) {
   if (!projectDirectoryName) {
     throw new Error('Missing required argument "[project-directory]"');
   }
+  const projectDirectoryPath = path.resolve(projectDirectoryName);
 
-  const projectDirectoryPath = path.resolve(projectDirectoryName); // Parse options
-
+  // Parse options
   let tagOrBranchVersion = options.templateVersion || 'main';
   tagOrBranchVersion = isSemVer(tagOrBranchVersion) && !_startsWithInstanceProperty(tagOrBranchVersion).call(tagOrBranchVersion, 'v') ? "v".concat(tagOrBranchVersion) : tagOrBranchVersion;
-  const templateName = options.template; // Validate options
+  const templateName = options.template;
 
+  // Validate options
   throwIfProjectDirectoryExists(projectDirectoryName, projectDirectoryPath);
-  throwIfTemplateIsNotSupported(templateName); // Read prompts
+  throwIfTemplateIsNotSupported(templateName);
 
+  // Read prompts
   const rl = readline.createInterface({
     input: process.stdin,
     output: process.stdout
@@ -257,18 +235,17 @@ async function processOptions(projectDirectoryName, options) {
     templateName,
     tagOrBranchVersion,
     entryPointUriPath,
-    initialProjectKey
+    initialProjectKey,
+    packageManager: options.packageManager
   };
 }
 
 const filesToBeRemoved = ['CHANGELOG.md'];
-
 function downloadTemplate(options) {
   return {
     title: 'Downloading template',
     task: () => {
       var _context;
-
       const tmpDir = os.tmpdir();
       const tmpFolderNameForClonedRepository = ['merchant-center-application-kit', '--', options.tagOrBranchVersion, '--', _Date$now().toString()].join('');
       const clonedRepositoryPath = path.join(tmpDir, tmpFolderNameForClonedRepository);
@@ -281,11 +258,9 @@ function downloadTemplate(options) {
             cwd: tmpDir,
             encoding: 'utf-8'
           });
-
           if (result.failed) {
             throw new Error(result.stderr);
           }
-
           throwIfTemplateVersionDoesNotExist(options.templateName, clonedRepositoryPath, options.tagOrBranchVersion);
           return result.stdout;
         }
@@ -293,21 +268,18 @@ function downloadTemplate(options) {
         title: _concatInstanceProperty(_context = "Copying template ".concat(options.templateName, " into project directory ")).call(_context, options.projectDirectoryPath),
         task: async () => {
           const command = process.platform === 'win32' || process.platform === 'cygwin' ? 'move' : 'mv';
-          const result = await execa(command, [templateFolderPath, // Wrap folder path in quotes to avoid issues with empty spaces in the folder names.
+          const result = await execa(command, [templateFolderPath,
+          // Wrap folder path in quotes to avoid issues with empty spaces in the folder names.
           options.projectDirectoryPath], {
             encoding: 'utf-8'
           });
-
           if (result.failed) {
             throw new Error(result.stderr);
           }
-
           const templatePackageJsonPath = path.join(options.projectDirectoryPath, 'package.json');
-
           if (!fs.existsSync(templatePackageJsonPath)) {
             throw new Error("Unable to verify that the template application has a package.json at \"".concat(templatePackageJsonPath, "\""));
           }
-
           return result.stdout;
         }
       }, {
@@ -317,11 +289,9 @@ function downloadTemplate(options) {
           const result = await execa(command, _mapInstanceProperty(filesToBeRemoved).call(filesToBeRemoved, filePath => path.join(options.projectDirectoryPath, filePath)), {
             encoding: 'utf-8'
           });
-
           if (result.failed) {
             throw new Error(result.stderr);
           }
-
           return result.stdout;
         }
       }]);
@@ -333,10 +303,10 @@ function installDependencies(options) {
   return {
     title: 'Installing dependencies (this might take a while)',
     task: () => {
-      const useYarn = shouldUseYarn();
-      const packageManager = useYarn ? 'yarn' : 'npm'; // TODO: we could check for min yarn/npm versions
-      // See https://github.com/facebook/create-react-app/blob/0f4781e8507249ce29a9ac1409fece67c1a53c38/packages/create-react-app/createReactApp.js#L225-L254
+      const packageManager = getPreferredPackageManager(options);
 
+      // TODO: we could check for min yarn/npm versions
+      // See https://github.com/facebook/create-react-app/blob/0f4781e8507249ce29a9ac1409fece67c1a53c38/packages/create-react-app/createReactApp.js#L225-L254
       return execa(packageManager, ['install'], {
         cwd: options.projectDirectoryPath,
         encoding: 'utf-8'
@@ -346,25 +316,20 @@ function installDependencies(options) {
 }
 
 function ownKeys(object, enumerableOnly) { var keys = _Object$keys(object); if (_Object$getOwnPropertySymbols) { var symbols = _Object$getOwnPropertySymbols(object); enumerableOnly && (symbols = _filterInstanceProperty(symbols).call(symbols, function (sym) { return _Object$getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
-
 function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var _context2, _context3; var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? _forEachInstanceProperty(_context2 = ownKeys(Object(source), !0)).call(_context2, function (key) { _defineProperty(target, key, source[key]); }) : _Object$getOwnPropertyDescriptors ? _Object$defineProperties(target, _Object$getOwnPropertyDescriptors(source)) : _forEachInstanceProperty(_context3 = ownKeys(Object(source))).call(_context3, function (key) { _Object$defineProperty(target, key, _Object$getOwnPropertyDescriptor(source, key)); }); } return target; }
-
 const replaceApplicationKitPackageVersionWith = function (releaseVersion) {
   var _context;
-
   let dependencies = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
   return _reduceInstanceProperty(_context = _Object$entries(dependencies)).call(_context, (updatedDependencies, _ref) => {
     let _ref2 = _slicedToArray(_ref, 2),
-        dependencyName = _ref2[0],
-        dependencyVersion = _ref2[1];
-
+      dependencyName = _ref2[0],
+      dependencyVersion = _ref2[1];
     const updatedVersion = dependencyVersion === 'workspace:*' ? releaseVersion : dependencyVersion;
     return _objectSpread(_objectSpread({}, updatedDependencies), {}, {
       [dependencyName]: updatedVersion
     });
   }, {});
 };
-
 function updatePackageJson(options, releaseVersion) {
   return {
     title: 'Updating package.json',
@@ -373,7 +338,7 @@ function updatePackageJson(options, releaseVersion) {
       const appPackageJson = JSON.parse(fs.readFileSync(packageJsonPath, {
         encoding: 'utf8'
       }));
-
+      const packageManager = getPreferredPackageManager(options);
       const updatedAppPackageJson = _Object$assign({}, appPackageJson, {
         version: '1.0.0',
         // Given the package name is derived from the `projectDirectoryName`
@@ -384,9 +349,11 @@ function updatePackageJson(options, releaseVersion) {
         description: '',
         // Replace the package versions with the `workspace:` syntax to the real version.
         dependencies: replaceApplicationKitPackageVersionWith(releaseVersion, appPackageJson.dependencies),
-        devDependencies: replaceApplicationKitPackageVersionWith(releaseVersion, appPackageJson.devDependencies)
+        devDependencies: replaceApplicationKitPackageVersionWith(releaseVersion, appPackageJson.devDependencies),
+        scripts: _objectSpread(_objectSpread({}, appPackageJson.scripts), {}, {
+          'start:prod:local': appPackageJson.scripts['start:prod:local'].replace('yarn', packageManager)
+        })
       });
-
       fs.writeFileSync(packageJsonPath, _JSON$stringify(updatedAppPackageJson, null, 2) + os.EOL, {
         encoding: 'utf8'
       });
@@ -406,32 +373,27 @@ function replaceApplicationInfoInCustomApplicationConfig(filePath, options) {
             }) && nodePath.parent.type === 'ObjectProperty') {
               nodePath.parent.value = types.stringLiteral(appName);
             }
-
             if (nodePath.isIdentifier({
               name: 'initialProjectKey'
             }) && nodePath.parent.type === 'ObjectProperty') {
               nodePath.parent.value = types.stringLiteral(options.initialProjectKey);
             }
-
             if (nodePath.isIdentifier({
               name: 'defaultLabel'
             })) {
               const isMainMenuLinkParent = nodePath.findParent(parentPath => parentPath.isIdentifier({
                 name: 'mainMenuLink'
               }));
-
               if (isMainMenuLinkParent && nodePath.parent.type === 'ObjectProperty') {
                 nodePath.parent.value = types.stringLiteral(appName);
               }
             }
           }
-
         }
       };
     }],
     retainLines: true
   });
-
   if (result !== null && result !== void 0 && result.code) {
     const prettierConfig = prettier.resolveConfig.sync(options.projectDirectoryPath);
     const formattedData = prettier.format(result.code + os.EOL, prettierConfig !== null && prettierConfig !== void 0 ? prettierConfig : undefined);
@@ -440,7 +402,6 @@ function replaceApplicationInfoInCustomApplicationConfig(filePath, options) {
     });
   }
 }
-
 function updateCustomApplicationConfig(options) {
   return {
     title: 'Updating Custom Applications config',
@@ -461,13 +422,11 @@ function replaceEntryPointUriPathInConstants(filePath, options) {
               nodePath.node.init = types.stringLiteral(options.entryPointUriPath);
             }
           }
-
         }
       };
     }],
     retainLines: true
   });
-
   if (result !== null && result !== void 0 && result.code) {
     const prettierConfig = prettier.resolveConfig.sync(options.projectDirectoryPath);
     const formattedData = prettier.format(result.code + os.EOL, prettierConfig !== null && prettierConfig !== void 0 ? prettierConfig : undefined);
@@ -476,7 +435,6 @@ function replaceEntryPointUriPathInConstants(filePath, options) {
     });
   }
 }
-
 function updateApplicationConstants(options) {
   return {
     title: 'Updating application constants',
@@ -488,14 +446,14 @@ function updateApplicationConstants(options) {
 }
 
 throwIfNodeVersionIsNotSupported(process.versions.node, pkgJson.engines.node);
-const cli = cac('create-mc-app'); // Makes the script crash on unhandled rejections instead of silently
+const cli = cac('create-mc-app');
+
+// Makes the script crash on unhandled rejections instead of silently
 // ignoring them. In the future, promise rejections that are not handled will
 // terminate the Node.js process with a non-zero exit code.
-
 process.on('unhandledRejection', err => {
   throw err;
 });
-
 const run = () => {
   // Default command
   cli.command('[project-directory]').usage('[project-directory]\n\n  Bootstraps a new Custom Application project using one of the predefined templates.').option('--template <name>', '(optional) The name of the template to install.', {
@@ -506,34 +464,33 @@ const run = () => {
     default: false
   }).option('--yes', '(optional) If set, the prompt options with default values will be skipped.', {
     default: false
-  }).option('--entry-point-uri-path <value>', '(optional) The version of the template to install. (default: starter-<hash>)').option('--initial-project-key <value>', '(optional) A commercetools project key used for the initial login in development. By default, the value is prompted in the terminal.').action(async (projectDirectory, options) => {
+  }).option('--entry-point-uri-path <value>', '(optional) The version of the template to install. (default: starter-<hash>)').option('--initial-project-key <value>', '(optional) A commercetools project key used for the initial login in development. By default, the value is prompted in the terminal.').option('--package-manager <value>', '(optional) The preferred package manager to use: npm, yarn, pnpm.').action(async (projectDirectory, options) => {
     var _context;
-
     if (!projectDirectory) {
       cli.outputHelp();
       return;
     }
-
     const releaseVersion = await getLatestReleaseVersion();
     hintOutdatedVersion(pkgJson.version, releaseVersion);
     console.log('');
     console.log("Documentation available at https://docs.commercetools.com/custom-applications");
     console.log('');
     const taskOptions = await processOptions(projectDirectory, options);
-    const taskList = new Listr(_filterInstanceProperty(_context = [downloadTemplate(taskOptions), updatePackageJson(taskOptions, releaseVersion), updateCustomApplicationConfig(taskOptions), updateApplicationConstants(taskOptions), !options.skipInstall && installDependencies(taskOptions)]).call(_context, Boolean));
+    const shouldInstallDependencies = !options.skipInstall ||
+    // TODO: remove once we manage to ensure the package manager is installed, for example via Corepack.
+    options.packageManager === 'pnpm';
+    const taskList = new Listr(_filterInstanceProperty(_context = [downloadTemplate(taskOptions), updatePackageJson(taskOptions, releaseVersion), updateCustomApplicationConfig(taskOptions), updateApplicationConstants(taskOptions), shouldInstallDependencies && installDependencies(taskOptions)]).call(_context, Boolean));
     await taskList.run();
-    const useYarn = shouldUseYarn();
+    const packageManager = getPreferredPackageManager(taskOptions);
     console.log('');
     console.log("\uD83C\uDF89 \uD83C\uDF89 \uD83C\uDF89 The Custom Application has been created in the \"".concat(taskOptions.projectDirectoryName, "\" folder."));
     console.log('');
     console.log("To get started:");
     console.log("$ cd ".concat(taskOptions.projectDirectoryName));
-
-    if (options.skipInstall) {
-      console.log("$ ".concat(useYarn ? 'yarn' : 'npm', " install"));
+    if (!shouldInstallDependencies) {
+      console.log("$ ".concat(packageManager, " install"));
     }
-
-    console.log("$ ".concat(useYarn ? 'yarn' : 'npm', " start"));
+    console.log("$ ".concat(packageManager, " start"));
     console.log('');
     console.log("Visit https://docs.commercetools.com/custom-applications for more info about developing Custom Applications. Enjoy \uD83D\uDE80");
   });

package/dist/declarations/src/types.d.ts

@@ -1,13 +1,16 @@
 export type TCliGlobalOptions = {
     '--'?: string[];
 };
+export type TTemplate = 'starter' | 'starter-typescript';
+export type TPackageManager = 'npm' | 'yarn' | 'pnpm';
 export type TCliCommandOptions = {
-    template: 'starter' | 'starter-typescript';
+    template: TTemplate;
     templateVersion: string;
     skipInstall: boolean;
     yes: boolean;
     entryPointUriPath?: string;
     initialProjectKey?: string;
+    packageManager?: TPackageManager;
 };
 export type TCliTaskOptions = {
     projectDirectoryName: string;
@@ -16,4 +19,5 @@ export type TCliTaskOptions = {
     tagOrBranchVersion: string;
     entryPointUriPath: string;
     initialProjectKey: string;
+    packageManager: TCliCommandOptions['packageManager'];
 };

package/dist/declarations/src/utils.d.ts

@@ -1,7 +1,9 @@
+import type { TCliTaskOptions, TPackageManager } from './types';
 declare const isSemVer: (version: string) => boolean;
 declare const shouldUseYarn: () => boolean;
+declare const getPreferredPackageManager: (options: TCliTaskOptions) => TPackageManager;
 declare const slugify: (name: string) => string;
 declare const upperFirst: (value: string) => string;
 declare const wordify: (slug: string) => string;
 declare const resolveFilePathByExtension: (requestedModule: string) => string;
-export { isSemVer, shouldUseYarn, slugify, wordify, upperFirst, resolveFilePathByExtension, };
+export { isSemVer, shouldUseYarn, slugify, wordify, upperFirst, resolveFilePathByExtension, getPreferredPackageManager, };

package/dist/declarations/src/validations.d.ts

@@ -1,5 +1,5 @@
-import type { TCliCommandOptions } from './types';
-declare const throwIfTemplateIsNotSupported: (templateName: TCliCommandOptions['template']) => void;
+import type { TTemplate } from './types';
+declare const throwIfTemplateIsNotSupported: (templateName: TTemplate) => void;
 declare const throwIfProjectDirectoryExists: (dirName: string, dirPath: string) => void;
 declare const throwIfTemplateVersionDoesNotExist: (templateName: string, templateFolderPath: string, versionToCheck: string) => void;
 declare const throwIfInitialProjectKeyIsMissing: (initialProjectKey?: string) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@commercetools-frontend/create-mc-app",
-  "version": "22.2.0",
+  "version": "22.3.0",
   "description": "Create Merchant Center applications to quickly get up and running",
   "bugs": "https://github.com/commercetools/merchant-center-application-kit/issues",
   "repository": {
@@ -9,7 +9,12 @@
     "directory": "packages/create-mc-app"
   },
   "homepage": "https://docs.commercetools.com/custom-applications",
-  "keywords": ["javascript", "frontend", "react", "toolkit"],
+  "keywords": [
+    "javascript",
+    "frontend",
+    "react",
+    "toolkit"
+  ],
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -21,6 +26,8 @@
     "@babel/core": "^7.20.12",
     "@babel/runtime": "^7.20.13",
     "@babel/runtime-corejs3": "^7.20.13",
+    "@types/babel__core": "^7.20.0",
+    "@types/semver": "^7.5.0",
     "cac": "6.7.14",
     "execa": "5.1.1",
     "listr2": "5.0.8",
@@ -33,4 +40,4 @@
   "engines": {
     "node": "16.x || >=18.0.0"
   }
-}
+}

package/src/cli.ts

@@ -6,7 +6,7 @@ import hintOutdatedVersion from './hint-outdated-version';
 import processOptions from './process-options';
 import * as tasks from './tasks';
 import type { TCliCommandOptions } from './types';
-import { shouldUseYarn } from './utils';
+import { getPreferredPackageManager } from './utils';
 import { throwIfNodeVersionIsNotSupported } from './validations';
 
 throwIfNodeVersionIsNotSupported(process.versions.node, pkgJson.engines.node);
@@ -55,6 +55,10 @@ const run = () => {
       '--initial-project-key <value>',
       '(optional) A commercetools project key used for the initial login in development. By default, the value is prompted in the terminal.'
     )
+    .option(
+      '--package-manager <value>',
+      '(optional) The preferred package manager to use: npm, yarn, pnpm.'
+    )
     .action(async (projectDirectory, options: TCliCommandOptions) => {
       if (!projectDirectory) {
         cli.outputHelp();
@@ -73,18 +77,23 @@ const run = () => {
 
       const taskOptions = await processOptions(projectDirectory, options);
 
+      const shouldInstallDependencies =
+        !options.skipInstall ||
+        // TODO: remove once we manage to ensure the package manager is installed, for example via Corepack.
+        options.packageManager === 'pnpm';
+
       const taskList = new Listr(
         [
           tasks.downloadTemplate(taskOptions),
           tasks.updatePackageJson(taskOptions, releaseVersion),
           tasks.updateCustomApplicationConfig(taskOptions),
           tasks.updateApplicationConstants(taskOptions),
-          !options.skipInstall && tasks.installDependencies(taskOptions),
+          shouldInstallDependencies && tasks.installDependencies(taskOptions),
         ].filter(Boolean) as ListrTask[]
       );
 
       await taskList.run();
-      const useYarn = shouldUseYarn();
+      const packageManager = getPreferredPackageManager(taskOptions);
 
       console.log('');
       console.log(
@@ -93,10 +102,10 @@ const run = () => {
       console.log('');
       console.log(`To get started:`);
       console.log(`$ cd ${taskOptions.projectDirectoryName}`);
-      if (options.skipInstall) {
-        console.log(`$ ${useYarn ? 'yarn' : 'npm'} install`);
+      if (!shouldInstallDependencies) {
+        console.log(`$ ${packageManager} install`);
       }
-      console.log(`$ ${useYarn ? 'yarn' : 'npm'} start`);
+      console.log(`$ ${packageManager} start`);
       console.log('');
       console.log(
         `Visit https://docs.commercetools.com/custom-applications for more info about developing Custom Applications. Enjoy 🚀`

package/src/process-options.ts

@@ -91,6 +91,7 @@ async function processOptions(
     tagOrBranchVersion,
     entryPointUriPath,
     initialProjectKey,
+    packageManager: options.packageManager,
   };
 }
 

package/src/tasks/install-dependencies.ts

@@ -1,14 +1,14 @@
 import execa from 'execa';
 import type { ListrTask } from 'listr2';
 import type { TCliTaskOptions } from '../types';
-import { shouldUseYarn } from '../utils';
+import { getPreferredPackageManager } from '../utils';
 
 function installDependencies(options: TCliTaskOptions): ListrTask {
   return {
     title: 'Installing dependencies (this might take a while)',
     task: () => {
-      const useYarn = shouldUseYarn();
-      const packageManager = useYarn ? 'yarn' : 'npm';
+      const packageManager = getPreferredPackageManager(options);
+
       // TODO: we could check for min yarn/npm versions
       // See https://github.com/facebook/create-react-app/blob/0f4781e8507249ce29a9ac1409fece67c1a53c38/packages/create-react-app/createReactApp.js#L225-L254
       return execa(packageManager, ['install'], {

package/src/tasks/update-package-json.ts

@@ -3,7 +3,7 @@ import os from 'os';
 import path from 'path';
 import type { ListrTask } from 'listr2';
 import type { TCliTaskOptions } from '../types';
-import { slugify } from '../utils';
+import { getPreferredPackageManager, slugify } from '../utils';
 
 const replaceApplicationKitPackageVersionWith = (
   releaseVersion: string,
@@ -37,6 +37,7 @@ function updatePackageJson(
       const appPackageJson = JSON.parse(
         fs.readFileSync(packageJsonPath, { encoding: 'utf8' })
       );
+      const packageManager = getPreferredPackageManager(options);
 
       const updatedAppPackageJson = Object.assign({}, appPackageJson, {
         version: '1.0.0',
@@ -55,6 +56,12 @@ function updatePackageJson(
           releaseVersion,
           appPackageJson.devDependencies
         ),
+        scripts: {
+          ...appPackageJson.scripts,
+          'start:prod:local': appPackageJson.scripts[
+            'start:prod:local'
+          ].replace('yarn', packageManager),
+        },
       });
 
       fs.writeFileSync(