@hubspot/cli 7.5.1-beta.0 → 7.5.2-beta.0

package/commands/project/add.d.ts

@@ -1,7 +1,10 @@
 import { YargsCommandModule, CommonArgs } from '../../types/Yargs';
 type ProjectAddArgs = CommonArgs & {
-    type: string;
-    name: string;
+    type?: string;
+    name?: string;
+    features?: string[];
+    distribution?: string;
+    auth?: string;
 };
 declare const projectAddCommand: YargsCommandModule<unknown, ProjectAddArgs>;
 export default projectAddCommand;

package/commands/project/add.js

@@ -1,87 +1,38 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const path_1 = __importDefault(require("path"));
-const logger_1 = require("@hubspot/local-dev-lib/logger");
-const github_1 = require("@hubspot/local-dev-lib/github");
 const errorHandlers_1 = require("../../lib/errorHandlers");
 const usageTracking_1 = require("../../lib/usageTracking");
-const lang_1 = require("../../lib/lang");
-const projectAddPrompt_1 = require("../../lib/prompts/projectAddPrompt");
 const config_1 = require("../../lib/projects/config");
-const create_1 = require("../../lib/projects/create");
-const structure_1 = require("../../lib/projects/structure");
-const Projects_1 = require("../../types/Projects");
 const ui_1 = require("../../lib/ui");
-const constants_1 = require("../../lib/constants");
 const exitCodes_1 = require("../../lib/enums/exitCodes");
 const yargsUtils_1 = require("../../lib/yargsUtils");
+const en_1 = require("../../lang/en");
+const buildAndDeploy_1 = require("../../lib/projects/buildAndDeploy");
+const legacyAddComponent_1 = require("../../lib/projects/add/legacyAddComponent");
+const v3AddComponent_1 = require("../../lib/projects/add/v3AddComponent");
+const constants_1 = require("../../lib/constants");
+const logger_1 = require("../../lib/ui/logger");
 const command = 'add';
-const describe = (0, ui_1.uiBetaTag)((0, lang_1.i18n)(`commands.project.subcommands.add.describe`), false);
+const describe = (0, ui_1.uiBetaTag)(en_1.commands.project.add.describe, false);
 async function handler(args) {
-    const { derivedAccountId } = args;
-    (0, usageTracking_1.trackCommandUsage)('project-add', undefined, derivedAccountId);
-    const { projectConfig, projectDir } = await (0, config_1.getProjectConfig)();
-    if (!projectDir || !projectConfig) {
-        logger_1.logger.error((0, lang_1.i18n)(`commands.project.subcommands.add.error.locationInProject`));
-        process.exit(exitCodes_1.EXIT_CODES.ERROR);
-    }
-    // We currently only support adding private apps to projects
-    let projectContainsPublicApp = false;
-    try {
-        const components = await (0, structure_1.findProjectComponents)(projectDir);
-        projectContainsPublicApp = components.some(c => c.type === Projects_1.ComponentTypes.PublicApp);
-    }
-    catch (err) {
-        (0, errorHandlers_1.debugError)(err);
-    }
-    if (projectContainsPublicApp) {
-        logger_1.logger.error((0, lang_1.i18n)(`commands.project.subcommands.add.error.projectContainsPublicApp`));
-        process.exit(exitCodes_1.EXIT_CODES.ERROR);
-    }
-    logger_1.logger.log('');
-    logger_1.logger.log((0, lang_1.i18n)(`commands.project.subcommands.add.creatingComponent`, {
-        projectName: projectConfig.name,
-    }));
-    logger_1.logger.log('');
-    let latestRepoReleaseTag;
     try {
-        // We want the tag_name from the latest release of the components repo
-        const repoReleaseData = await (0, github_1.fetchReleaseData)(constants_1.HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH);
-        if (repoReleaseData) {
-            latestRepoReleaseTag = repoReleaseData.tag_name;
+        const { derivedAccountId } = args;
+        (0, usageTracking_1.trackCommandUsage)('project-add', undefined, derivedAccountId);
+        const { projectConfig, projectDir } = await (0, config_1.getProjectConfig)();
+        if (!projectDir || !projectConfig) {
+            logger_1.uiLogger.error(en_1.commands.project.add.error.locationInProject);
+            process.exit(exitCodes_1.EXIT_CODES.ERROR);
+        }
+        const isV3ProjectCreate = (0, buildAndDeploy_1.useV3Api)(projectConfig.platformVersion);
+        if (isV3ProjectCreate) {
+            await (0, v3AddComponent_1.v3AddComponent)(args, projectDir, projectConfig);
+        }
+        else {
+            await (0, legacyAddComponent_1.legacyAddComponent)(args, projectDir, projectConfig);
         }
     }
-    catch (err) {
-        (0, errorHandlers_1.debugError)(err);
-    }
-    if (!latestRepoReleaseTag) {
-        logger_1.logger.error((0, lang_1.i18n)(`commands.project.subcommands.add.error.failedToFetchComponentList`));
-        process.exit(exitCodes_1.EXIT_CODES.ERROR);
-    }
-    const components = await (0, create_1.getProjectComponentListFromRepo)(latestRepoReleaseTag);
-    if (!components.length) {
-        logger_1.logger.error((0, lang_1.i18n)(`commands.project.subcommands.add.error.failedToFetchComponentList`));
-        process.exit(exitCodes_1.EXIT_CODES.ERROR);
-    }
-    const projectAddPromptResponse = await (0, projectAddPrompt_1.projectAddPrompt)(components, args);
-    try {
-        const componentPath = path_1.default.join(projectDir, projectConfig.srcDir, projectAddPromptResponse.componentTemplate.insertPath, projectAddPromptResponse.name);
-        await (0, github_1.cloneGithubRepo)(constants_1.HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH, componentPath, {
-            sourceDir: projectAddPromptResponse.componentTemplate.path,
-            tag: latestRepoReleaseTag,
-            hideLogs: true,
-        });
-        logger_1.logger.log('');
-        logger_1.logger.success((0, lang_1.i18n)(`commands.project.subcommands.add.success`, {
-            componentName: projectAddPromptResponse.name,
-        }));
-    }
-    catch (error) {
-        (0, errorHandlers_1.debugError)(error);
-        logger_1.logger.error((0, lang_1.i18n)(`commands.project.subcommands.add.error.failedToDownloadComponent`));
+    catch (e) {
+        (0, errorHandlers_1.logError)(e);
         process.exit(exitCodes_1.EXIT_CODES.ERROR);
     }
     process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
@@ -89,24 +40,36 @@ async function handler(args) {
 function projectAddBuilder(yargs) {
     yargs.options({
         type: {
-            describe: (0, lang_1.i18n)(`commands.project.subcommands.add.options.type.describe`),
+            describe: en_1.commands.project.add.options.type.describe,
             type: 'string',
         },
         name: {
-            describe: (0, lang_1.i18n)(`commands.project.subcommands.add.options.name.describe`),
+            describe: en_1.commands.project.add.options.name.describe,
+            type: 'string',
+        },
+        distribution: {
+            describe: en_1.commands.project.add.options.distribution.describe,
+            hidden: true,
             type: 'string',
+            choices: [constants_1.privateDistribution, constants_1.marketplaceDistribution],
+        },
+        auth: {
+            describe: en_1.commands.project.add.options.auth.describe,
+            hidden: true,
+            type: 'string',
+            choices: [constants_1.oAuth, constants_1.staticAuth],
+        },
+        features: {
+            describe: en_1.commands.project.add.options.features.describe,
+            hidden: true,
+            type: 'array',
         },
     });
-    yargs.example([
-        [
-            '$0 project add',
-            (0, lang_1.i18n)(`commands.project.subcommands.add.examples.default`),
-        ],
-    ]);
+    yargs.example([['$0 project add', en_1.commands.project.add.examples.default]]);
     yargs.example([
         [
             '$0 project add --name="my-component" --type="components/example-app"',
-            (0, lang_1.i18n)(`commands.project.subcommands.add.examples.withFlags`),
+            en_1.commands.project.add.examples.withFlags,
         ],
     ]);
     return yargs;

package/commands/project/create.d.ts

@@ -1,10 +1,4 @@
-import { RepoPath } from '@hubspot/local-dev-lib/types/Github';
-import { AccountArgs, CommonArgs, ConfigArgs, EnvironmentArgs, YargsCommandModule } from '../../types/Yargs';
-type ProjectCreateArgs = CommonArgs & ConfigArgs & AccountArgs & EnvironmentArgs & {
-    name?: string;
-    dest?: string;
-    templateSource?: RepoPath;
-    template?: string;
-};
+import { YargsCommandModule } from '../../types/Yargs';
+import { ProjectCreateArgs } from '../../lib/projects/create';
 declare const projectCreateCommand: YargsCommandModule<unknown, ProjectCreateArgs>;
 export default projectCreateCommand;

package/commands/project/create.js

@@ -5,71 +5,75 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const path_1 = __importDefault(require("path"));
 const fs_extra_1 = __importDefault(require("fs-extra"));
-const chalk_1 = __importDefault(require("chalk"));
-const logger_1 = require("@hubspot/local-dev-lib/logger");
 const github_1 = require("@hubspot/local-dev-lib/github");
 const path_2 = require("@hubspot/local-dev-lib/path");
 const usageTracking_1 = require("../../lib/usageTracking");
-const createProjectPrompt_1 = require("../../lib/prompts/createProjectPrompt");
 const config_1 = require("../../lib/projects/config");
-const create_1 = require("../../lib/projects/create");
-const lang_1 = require("../../lib/lang");
+const legacy_1 = require("../../lib/projects/create/legacy");
+const v3_1 = require("../../lib/projects/create/v3");
 const ui_1 = require("../../lib/ui");
 const errorHandlers_1 = require("../../lib/errorHandlers");
 const exitCodes_1 = require("../../lib/enums/exitCodes");
 const constants_1 = require("../../lib/constants");
 const yargsUtils_1 = require("../../lib/yargsUtils");
-const command = 'create';
-const describe = (0, ui_1.uiBetaTag)((0, lang_1.i18n)(`commands.project.subcommands.create.describe`), false);
+const projects_1 = require("@hubspot/local-dev-lib/constants/projects");
+const en_1 = require("../../lang/en");
+const logger_1 = require("../../lib/ui/logger");
+const v3_2 = require("../../lib/projects/create/v3");
+const create_1 = require("../../lib/projects/create");
+const command = ['create', 'init'];
+const describe = (0, ui_1.uiBetaTag)(en_1.commands.project.create.describe, false);
+const { v2023_2, v2025_1, v2025_2 } = projects_1.PLATFORM_VERSIONS;
 async function handler(args) {
-    const { derivedAccountId } = args;
-    let latestRepoReleaseTag;
-    let templateSource = args.templateSource;
-    if (!templateSource) {
-        templateSource = constants_1.HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH;
-        try {
-            const releaseData = await (0, github_1.fetchReleaseData)(constants_1.HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH);
-            if (releaseData) {
-                latestRepoReleaseTag = releaseData.tag_name;
-            }
-        }
-        catch (err) {
-            logger_1.logger.error((0, lang_1.i18n)(`commands.project.subcommands.create.errors.failedToFetchProjectList`));
-            process.exit(exitCodes_1.EXIT_CODES.ERROR);
-        }
-    }
-    if (!templateSource || !templateSource.includes('/')) {
-        logger_1.logger.error((0, lang_1.i18n)(`commands.project.subcommands.create.errors.invalidTemplateSource`));
+    const { derivedAccountId, platformVersion, templateSource } = args;
+    if (templateSource && !templateSource.includes('/')) {
+        logger_1.uiLogger.error(en_1.commands.project.create.errors.invalidTemplateSource);
         process.exit(exitCodes_1.EXIT_CODES.ERROR);
     }
-    const projectTemplates = await (0, create_1.getProjectTemplateListFromRepo)(templateSource, latestRepoReleaseTag || constants_1.DEFAULT_PROJECT_TEMPLATE_BRANCH);
-    if (!projectTemplates.length) {
-        logger_1.logger.error((0, lang_1.i18n)(`commands.project.subcommands.create.errors.failedToFetchProjectList`));
+    const repo = templateSource || constants_1.HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH;
+    let handleResult;
+    try {
+        handleResult = await (0, create_1.handleProjectCreationFlow)(args);
+    }
+    catch (error) {
+        (0, errorHandlers_1.logError)(error);
         process.exit(exitCodes_1.EXIT_CODES.ERROR);
     }
-    const createProjectPromptResponse = await (0, createProjectPrompt_1.createProjectPrompt)(args, projectTemplates);
+    const { authType, distribution, repoConfig, projectContents, createProjectPromptResponse, } = handleResult;
+    (0, usageTracking_1.trackCommandUsage)('project-create', {
+        type: createProjectPromptResponse.projectTemplate?.name ||
+            (createProjectPromptResponse.componentTemplates || [])
+                // @ts-expect-error
+                .map((item) => item.label)
+                .join(','),
+    }, derivedAccountId);
     const projectDest = path_1.default.resolve((0, path_2.getCwd)(), createProjectPromptResponse.dest);
-    (0, usageTracking_1.trackCommandUsage)('project-create', { type: createProjectPromptResponse.projectTemplate.name }, derivedAccountId);
     const { projectConfig: existingProjectConfig, projectDir: existingProjectDir, } = await (0, config_1.getProjectConfig)(projectDest);
     // Exit if the target destination is within an existing project
     if (existingProjectConfig &&
         existingProjectDir &&
         projectDest.startsWith(existingProjectDir)) {
-        logger_1.logger.error((0, lang_1.i18n)(`commands.project.subcommands.create.errors.cannotNestProjects`, {
-            projectDir: existingProjectDir,
-        }));
+        logger_1.uiLogger.error(en_1.commands.project.create.errors.cannotNestProjects(existingProjectDir));
         process.exit(exitCodes_1.EXIT_CODES.ERROR);
     }
+    const components = (0, v3_2.generateComponentPaths)({
+        createProjectPromptResponse,
+        platformVersion,
+        repoConfig,
+        projectContents,
+        authType,
+        distribution,
+    });
     try {
-        await (0, github_1.cloneGithubRepo)(templateSource, projectDest, {
-            sourceDir: createProjectPromptResponse.projectTemplate.path,
-            tag: latestRepoReleaseTag,
+        await (0, github_1.cloneGithubRepo)(repo, projectDest, {
+            sourceDir: createProjectPromptResponse.projectTemplate?.path || components,
             hideLogs: true,
+            branch: 'main',
         });
     }
     catch (err) {
         (0, errorHandlers_1.debugError)(err);
-        logger_1.logger.error((0, lang_1.i18n)(`commands.project.subcommands.create.errors.failedToDownloadProject`));
+        logger_1.uiLogger.error(en_1.commands.project.create.errors.failedToDownloadProject);
         process.exit(exitCodes_1.EXIT_CODES.ERROR);
     }
     const projectConfigPath = path_1.default.join(projectDest, constants_1.PROJECT_CONFIG_FILE);
@@ -79,17 +83,13 @@ async function handler(args) {
         name: createProjectPromptResponse.name,
     });
     // If the template is 'no-template', we need to manually create a src directory
-    if (createProjectPromptResponse.projectTemplate.name ===
-        create_1.EMPTY_PROJECT_TEMPLATE_NAME) {
+    if (createProjectPromptResponse.projectTemplate?.name ===
+        legacy_1.EMPTY_PROJECT_TEMPLATE_NAME ||
+        projectContents === v3_1.EMPTY_PROJECT) {
         fs_extra_1.default.ensureDirSync(path_1.default.join(projectDest, 'src'));
     }
-    logger_1.logger.log('');
-    logger_1.logger.success((0, lang_1.i18n)(`commands.project.subcommands.create.logs.success`, {
-        projectName: createProjectPromptResponse.name,
-        projectDest,
-    }));
-    logger_1.logger.log('');
-    logger_1.logger.log(chalk_1.default.bold((0, lang_1.i18n)(`commands.project.subcommands.create.logs.welcomeMessage`)));
+    logger_1.uiLogger.success(en_1.commands.project.create.logs.success(createProjectPromptResponse.name, projectDest));
+    logger_1.uiLogger.log(en_1.commands.project.create.logs.welcomeMessage);
     (0, ui_1.uiFeatureHighlight)([
         'projectCommandTip',
         'projectUploadCommand',
@@ -104,32 +104,61 @@ async function handler(args) {
 function projectCreateBuilder(yargs) {
     yargs.options({
         name: {
-            describe: (0, lang_1.i18n)(`commands.project.subcommands.create.options.name.describe`),
+            describe: en_1.commands.project.create.options.name.describe,
             type: 'string',
         },
         dest: {
-            describe: (0, lang_1.i18n)(`commands.project.subcommands.create.options.dest.describe`),
+            describe: en_1.commands.project.create.options.dest.describe,
             type: 'string',
         },
         template: {
-            describe: (0, lang_1.i18n)(`commands.project.subcommands.create.options.template.describe`),
+            // TODO: When we release 2025.2 scaffolding, we need to point out this is only valid for 2025.1 prior
+            describe: en_1.commands.project.create.options.template.describe,
             type: 'string',
         },
         'template-source': {
-            describe: (0, lang_1.i18n)(`commands.project.subcommands.create.options.templateSource.describe`),
+            describe: en_1.commands.project.create.options.templateSource.describe,
+            type: 'string',
+        },
+        'platform-version': {
+            describe: en_1.commands.project.create.options.platformVersion.describe,
+            hidden: true,
             type: 'string',
+            choices: [v2023_2, v2025_1, v2025_2],
+            default: v2023_2,
+        },
+        'project-base': {
+            describe: en_1.commands.project.create.options.projectBase.describe,
+            hidden: true,
+            type: 'string',
+            choices: [v3_1.EMPTY_PROJECT, v3_1.PROJECT_WITH_APP],
+        },
+        distribution: {
+            describe: en_1.commands.project.create.options.distribution.describe,
+            hidden: true,
+            type: 'string',
+            choices: [constants_1.privateDistribution, constants_1.marketplaceDistribution],
+        },
+        auth: {
+            describe: en_1.commands.project.create.options.auth.describe,
+            hidden: true,
+            type: 'string',
+            choices: [constants_1.oAuth, constants_1.staticAuth],
+        },
+        features: {
+            describe: en_1.commands.project.create.options.features.describe,
+            hidden: true,
+            type: 'array',
         },
     });
+    yargs.conflicts('template', 'features');
     yargs.example([
-        [
-            '$0 project create',
-            (0, lang_1.i18n)(`commands.project.subcommands.create.examples.default`),
-        ],
+        ['$0 project create', en_1.commands.project.create.examples.default],
     ]);
     yargs.example([
         [
             '$0 project create --template-source HubSpot/ui-extensions-examples',
-            (0, lang_1.i18n)(`commands.project.subcommands.create.examples.templateSource`),
+            en_1.commands.project.create.examples.templateSource,
         ],
     ]);
     return yargs;

package/commands/project/dev/unifiedFlow.js

@@ -124,6 +124,7 @@ async function unifiedProjectDevFlow({ args, targetProjectAccountId, providedTar
         targetTestingAccountId: targetTestingAccountId,
         projectConfig,
         projectDir,
+        projectName: project.name,
         projectId: project.id,
         env,
     });

package/lang/en.d.ts

@@ -878,7 +878,13 @@ Local development of unified apps is currently only compatible with accounts tha
             };
             readonly logs: {
                 readonly success: (projectName: string, projectDest: string) => string;
-                readonly welcomeMessage: "Welcome to HubSpot Developer Projects!";
+                readonly welcomeMessage: `
+${string}`;
+            };
+            readonly prompts: {
+                readonly parentComponents: "[--project-base] What would you like in your project?";
+                readonly emptyProject: "Empty Project";
+                readonly app: "App";
             };
             readonly examples: {
                 readonly default: "Create a new project";
@@ -897,6 +903,21 @@ Local development of unified apps is currently only compatible with accounts tha
                 readonly templateSource: {
                     readonly describe: "Path to custom GitHub repository from which to create project template";
                 };
+                readonly platformVersion: {
+                    readonly describe: "The target platform version for the new project.";
+                };
+                readonly projectBase: {
+                    readonly describe: "The top level component to include in the project.";
+                };
+                readonly distribution: {
+                    readonly describe: "How the app will be distributed.";
+                };
+                readonly auth: {
+                    readonly describe: "Authentication model for the application.";
+                };
+                readonly features: {
+                    readonly describe: "Features to include in the project. Only valid if project-base is app";
+                };
             };
         };
         readonly migrateApp: {
@@ -982,11 +1003,23 @@ Local development of unified apps is currently only compatible with accounts tha
                 readonly type: {
                     readonly describe: "The path to the component type's location within the hubspot-project-components Github repo: https://github.com/HubSpot/hubspot-project-components";
                 };
+                readonly distribution: {
+                    readonly describe: "The distribution method for the application.";
+                };
+                readonly auth: {
+                    readonly describe: "The authentication type for the application.";
+                };
+                readonly features: {
+                    readonly describe: "Which features to include with the application.";
+                };
             };
             readonly creatingComponent: (projectName: string) => string;
-            readonly success: (componentName: string) => string;
+            readonly success: (componentName: string, multiple?: boolean) => string;
             readonly error: {
                 readonly failedToDownloadComponent: "Failed to download project component. Please try again later.";
+                readonly maxExceeded: (maxCount: number) => string;
+                readonly authTypeNotAllowed: (authType: string) => string;
+                readonly distributionNotAllowed: (dist: string) => string;
                 readonly locationInProject: "This command must be run from within a project directory.";
                 readonly failedToFetchComponentList: "Failed to fetch the list of available components. Please try again later.";
                 readonly projectContainsPublicApp: "This project contains a public app. This command is currently only compatible with projects that contain private apps.";
@@ -2355,10 +2388,21 @@ Run ${string} to upgrade to version ${string}`;
     };
     readonly projects: {
         readonly create: {
+            readonly prompt: {
+                readonly marketPlaceDistribution: "On the HubSpot marketplace";
+                readonly privateDistribution: "Privately";
+                readonly distribution: "[--distribution] How would you like to distribute your application?";
+                readonly auth: "[--auth] What type of authentication would you like your application to use";
+                readonly staticAuth: "Static Auth";
+                readonly oauth: "OAuth";
+            };
             readonly errors: {
                 readonly noProjectsInConfig: "Unable to find any projects in the target repository's config.json file. Please ensure that there is a \"projects\" array in the config file.";
                 readonly missingConfigFileTemplateSource: "Failed to fetch the config.json file from the target repository. Please ensure that there is a valid config.json file at the root of the repository and try again.";
-                readonly missingPropertiesInConfig: "Found misconfigured projects in the target repository's config.json file. Please ensure that each project in the target repository's config.json file contains the following properties: [\"name\", \"label\", \"path\", \"insertPath\"].";
+                readonly missingPropertiesInConfig: "Found misconfigured projects in the target repository's config.json file. Please ensure that each project in the target repository's config.json file contains the following properties: [\"name\", \"label\", \"path\"].";
+                readonly exceededMaxNumberOfApps: (max: number) => string;
+                readonly unableToParseAppConfig: (file: string) => string;
+                readonly invalidAuthDistCombo: (authType: string, distribution: string) => string;
             };
         };
         readonly validateProjectConfig: {
@@ -2718,7 +2762,9 @@ Run ${string} to upgrade to version ${string}`;
             readonly enterName: "[--name] Give your component a name: ";
             readonly errors: {
                 readonly nameRequired: "A component name is required";
+                readonly componentRequired: "Must select a feature to add";
                 readonly invalidType: (type: string) => string;
+                readonly cannotAddFeature: (feature: string, reasons: string | boolean) => string;
             };
         };
         readonly secretPrompt: {

package/lang/en.js

@@ -11,6 +11,7 @@ const config_1 = require("@hubspot/local-dev-lib/constants/config");
 const ui_1 = require("../lib/ui");
 const urls_1 = require("../lib/projects/urls");
 const constants_1 = require("../lib/constants");
+const v3_1 = require("../lib/projects/create/v3");
 exports.commands = {
     generalErrors: {
         srcIsProject: (src, command) => `"${src}" is in a project folder. Did you mean "hs project ${command}"?`,
@@ -878,8 +879,13 @@ exports.commands = {
                 cannotNestProjects: (projectDir) => `A project already exists at ${projectDir}. Projects cannot be nested within other projects. Please choose a different destination and try again.`,
             },
             logs: {
-                success: (projectName, projectDest) => `Project ${chalk_1.default.bold(projectName)} was successfully created in ${projectDest}`,
-                welcomeMessage: 'Welcome to HubSpot Developer Projects!',
+                success: (projectName, projectDest) => `\nProject ${chalk_1.default.bold(projectName)} was successfully created in ${projectDest}`,
+                welcomeMessage: `\n${chalk_1.default.bold('Welcome to HubSpot Developer Projects!')}`,
+            },
+            prompts: {
+                parentComponents: '[--project-base] What would you like in your project?',
+                emptyProject: 'Empty Project',
+                app: 'App',
             },
             examples: {
                 default: 'Create a new project',
@@ -898,6 +904,21 @@ exports.commands = {
                 templateSource: {
                     describe: 'Path to custom GitHub repository from which to create project template',
                 },
+                platformVersion: {
+                    describe: 'The target platform version for the new project.',
+                },
+                projectBase: {
+                    describe: 'The top level component to include in the project.',
+                },
+                distribution: {
+                    describe: 'How the app will be distributed.',
+                },
+                auth: {
+                    describe: 'Authentication model for the application.',
+                },
+                features: {
+                    describe: `Features to include in the project. Only valid if project-base is ${v3_1.PROJECT_WITH_APP}`,
+                },
             },
         },
         migrateApp: {
@@ -983,11 +1004,23 @@ exports.commands = {
                 type: {
                     describe: "The path to the component type's location within the hubspot-project-components Github repo: https://github.com/HubSpot/hubspot-project-components",
                 },
+                distribution: {
+                    describe: 'The distribution method for the application.',
+                },
+                auth: {
+                    describe: 'The authentication type for the application.',
+                },
+                features: {
+                    describe: 'Which features to include with the application.',
+                },
             },
-            creatingComponent: (projectName) => `Adding a new component to ${chalk_1.default.bold(projectName)}`,
-            success: (componentName) => `${componentName} was successfully added to your project.`,
+            creatingComponent: (projectName) => `\nAdding a new component to ${chalk_1.default.bold(projectName)}\n`,
+            success: (componentName, multiple = false) => `${componentName} ${multiple ? 'were' : 'was'} successfully added to your app.`,
             error: {
                 failedToDownloadComponent: 'Failed to download project component. Please try again later.',
+                maxExceeded: (maxCount) => `This project has the maximum allowed(${maxCount})`,
+                authTypeNotAllowed: (authType) => `Auth type '${authType}' not allowed.`,
+                distributionNotAllowed: (dist) => `Distribution '${dist}' not allowed.`,
                 locationInProject: 'This command must be run from within a project directory.',
                 failedToFetchComponentList: 'Failed to fetch the list of available components. Please try again later.',
                 projectContainsPublicApp: 'This project contains a public app. This command is currently only compatible with projects that contain private apps.',
@@ -2353,10 +2386,21 @@ exports.lib = {
     },
     projects: {
         create: {
+            prompt: {
+                marketPlaceDistribution: 'On the HubSpot marketplace',
+                privateDistribution: 'Privately',
+                distribution: '[--distribution] How would you like to distribute your application?',
+                auth: '[--auth] What type of authentication would you like your application to use',
+                staticAuth: 'Static Auth',
+                oauth: 'OAuth',
+            },
             errors: {
                 noProjectsInConfig: 'Unable to find any projects in the target repository\'s config.json file. Please ensure that there is a "projects" array in the config file.',
                 missingConfigFileTemplateSource: 'Failed to fetch the config.json file from the target repository. Please ensure that there is a valid config.json file at the root of the repository and try again.',
-                missingPropertiesInConfig: 'Found misconfigured projects in the target repository\'s config.json file. Please ensure that each project in the target repository\'s config.json file contains the following properties: ["name", "label", "path", "insertPath"].',
+                missingPropertiesInConfig: 'Found misconfigured projects in the target repository\'s config.json file. Please ensure that each project in the target repository\'s config.json file contains the following properties: ["name", "label", "path"].',
+                exceededMaxNumberOfApps: (max) => `This project currently has the maximum number of apps: ${max}`,
+                unableToParseAppConfig: (file) => `Unable to parse app file: ${file}`,
+                invalidAuthDistCombo: (authType, distribution) => `Invalid distribution and auth combination. Apps with distribution '${distribution}' must have auth '${authType}'`,
             },
         },
         validateProjectConfig: {
@@ -2714,7 +2758,9 @@ exports.lib = {
             enterName: '[--name] Give your component a name: ',
             errors: {
                 nameRequired: 'A component name is required',
+                componentRequired: 'Must select a feature to add',
                 invalidType: (type) => `[--type] Could not find type "${type}". Please choose an available type:`,
+                cannotAddFeature: (feature, reasons) => `Cannot Add feature '${feature}' to project for the following reasons: ${reasons}`,
             },
         },
         secretPrompt: {

package/lang/en.lyaml

@@ -1033,7 +1033,7 @@ en:
         errors:
           noProjectsInConfig: "Unable to find any projects in the target repository's config.json file. Please ensure that there is a \"projects\" array in the config file."
           missingConfigFileTemplateSource: "Failed to fetch the config.json file from the target repository. Please ensure that there is a valid config.json file at the root of the repository and try again."
-          missingPropertiesInConfig: "Found misconfigured projects in the target repository's config.json file. Please ensure that each project in the target repository's config.json file contains the following properties: [\"name\", \"label\", \"path\", \"insertPath\"]."
+          missingPropertiesInConfig: "Found misconfigured projects in the target repository's config.json file. Please ensure that each project in the target repository's config.json file contains the following properties: [\"name\", \"label\", \"path\"]."
       validateProjectConfig:
         configNotFound: "Unable to locate a project configuration file. Try running again from a project directory, or run {{ createCommand }} to create a new project."
         configMissingFields: "The project configuration file is missing required fields."

package/lib/constants.d.ts

@@ -82,7 +82,19 @@ export declare const LOCAL_DEV_UI_MESSAGE_SEND_TYPES: {
     UPLOAD_SUCCESS: string;
     UPLOAD_FAILURE: string;
     UPDATE_PROJECT_NODES: string;
+    UPDATE_APP_DATA: string;
+    UPDATE_PROJECT_DATA: string;
 };
 export declare const LOCAL_DEV_UI_MESSAGE_RECEIVE_TYPES: {
     UPLOAD: string;
 };
+export declare const APP_INSTALLATION_STATES: {
+    readonly NOT_INSTALLED: "NOT_INSTALLED";
+    readonly INSTALLED: "INSTALLED";
+    readonly INSTALLED_WITH_OUTDATED_SCOPES: "INSTALLED_WITH_OUTDATED_SCOPES";
+};
+export declare const staticAuth = "static";
+export declare const oAuth = "oauth";
+export declare const privateDistribution = "private";
+export declare const marketplaceDistribution = "marketplace";
+export declare const appComponent = "app";