@nocobase/cli 2.3.0-beta.3 → 3.0.0-alpha.11

package/dist/commands/api/swagger/get.js

@@ -0,0 +1,96 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { Command, Flags } from '@oclif/core';
+import { translateCli } from '../../../lib/cli-locale.js';
+import { executeSwaggerRequest, swaggerRequestFlags } from '../../../lib/swagger-command.js';
+import { renderTable } from '../../../lib/ui.js';
+const swaggerText = (key, values, fallback) => translateCli(`commands.swagger.${key}`, values, { fallback });
+function isRecord(value) {
+    return Boolean(value && typeof value === 'object' && !Array.isArray(value));
+}
+function unwrapData(value) {
+    if (!isRecord(value) || typeof value.openapi === 'string') {
+        return value;
+    }
+    return Object.prototype.hasOwnProperty.call(value, 'data') ? value.data : value;
+}
+function normalizeDocument(value) {
+    const document = unwrapData(value);
+    if (!isRecord(document) ||
+        typeof document.openapi !== 'string' ||
+        !isRecord(document.info) ||
+        !isRecord(document.paths)) {
+        return undefined;
+    }
+    return document;
+}
+export default class SwaggerGet extends Command {
+    static summary = 'Get a NocoBase OpenAPI document';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --json',
+        '<%= config.bin %> <%= command.id %> --namespace collections/orders --json',
+        '<%= config.bin %> <%= command.id %> --namespace plugins/ai --output ./openapi/ai.json',
+    ];
+    static flags = {
+        ...swaggerRequestFlags,
+        namespace: Flags.string({
+            aliases: ['ns'],
+            description: 'Document namespace, such as core, plugins/ai, or collections/orders',
+        }),
+        output: Flags.string({
+            char: 'o',
+            description: 'Write the OpenAPI document to a file',
+        }),
+        'json-output': Flags.boolean({
+            char: 'j',
+            aliases: ['json'],
+            description: 'Print the complete OpenAPI document as JSON',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SwaggerGet);
+        const namespace = flags.namespace?.trim() || undefined;
+        const response = await executeSwaggerRequest(this, flags, '/swagger:get', { ns: namespace });
+        if (!response) {
+            return;
+        }
+        if (!response.ok) {
+            const details = JSON.stringify(response.data, null, 2);
+            this.error(response.status === 404
+                ? swaggerText('errors.pluginDisabled', undefined, 'The API documentation plugin is not enabled. Enable it before requesting Swagger documents.')
+                : swaggerText('errors.requestFailed', { status: response.status, details }, `Swagger request failed with status ${response.status}\n${details}`));
+        }
+        const document = normalizeDocument(response.data);
+        if (!document) {
+            this.error(swaggerText('errors.invalidDocument', undefined, 'swagger:get returned an invalid OpenAPI document.'));
+        }
+        const json = `${JSON.stringify(document, null, 2)}\n`;
+        if (flags.output) {
+            const outputPath = path.resolve(flags.output);
+            await fs.mkdir(path.dirname(outputPath), { recursive: true });
+            await fs.writeFile(outputPath, json);
+            this.log(swaggerText('messages.saved', { output: outputPath }, `Saved Swagger document to ${outputPath}.`));
+            return;
+        }
+        if (flags['json-output']) {
+            this.log(json.trimEnd());
+            return;
+        }
+        this.log(renderTable([swaggerText('table.field', undefined, 'Field'), swaggerText('table.value', undefined, 'Value')], [
+            [swaggerText('fields.namespace', undefined, 'Namespace'), namespace ?? 'all'],
+            [swaggerText('fields.title', undefined, 'Title'), document.info.title ?? ''],
+            [swaggerText('fields.version', undefined, 'Version'), document.info.version ?? ''],
+            [swaggerText('fields.openapi', undefined, 'OpenAPI'), document.openapi],
+            [swaggerText('fields.paths', undefined, 'Paths'), String(Object.keys(document.paths).length)],
+        ]));
+    }
+}

package/dist/commands/api/swagger/index.js

@@ -0,0 +1,20 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { Command, loadHelpClass } from '@oclif/core';
+export default class Swagger extends Command {
+    static summary = 'Inspect the current NocoBase OpenAPI documentation';
+    async run() {
+        await this.parse(Swagger);
+        const Help = await loadHelpClass(this.config);
+        await new Help(this.config, this.config.pjson.oclif.helpOptions ?? this.config.pjson.helpOptions).showHelp([
+            this.id ?? 'api:swagger',
+            ...this.argv,
+        ]);
+    }
+}

package/dist/commands/api/swagger/list.js

@@ -0,0 +1,92 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { Command, Flags } from '@oclif/core';
+import { translateCli } from '../../../lib/cli-locale.js';
+import { executeSwaggerRequest, swaggerRequestFlags } from '../../../lib/swagger-command.js';
+import { renderTable } from '../../../lib/ui.js';
+const swaggerText = (key, values, fallback) => translateCli(`commands.swagger.${key}`, values, { fallback });
+function isRecord(value) {
+    return Boolean(value && typeof value === 'object' && !Array.isArray(value));
+}
+function unwrapData(value) {
+    return isRecord(value) && Object.prototype.hasOwnProperty.call(value, 'data') ? value.data : value;
+}
+function readNamespace(url) {
+    try {
+        return new URL(url, 'http://localhost').searchParams.get('ns') || 'all';
+    }
+    catch {
+        return 'all';
+    }
+}
+function normalizeDestinations(value) {
+    const data = unwrapData(value);
+    if (!Array.isArray(data)) {
+        return undefined;
+    }
+    const destinations = [];
+    for (const item of data) {
+        if (!isRecord(item) || typeof item.name !== 'string' || typeof item.url !== 'string') {
+            return undefined;
+        }
+        destinations.push({
+            name: item.name,
+            namespace: readNamespace(item.url),
+            url: item.url,
+        });
+    }
+    return destinations;
+}
+export default class SwaggerList extends Command {
+    static summary = 'List available NocoBase OpenAPI document namespaces';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --json',
+        '<%= config.bin %> <%= command.id %> --env dev --yes --json',
+    ];
+    static flags = {
+        ...swaggerRequestFlags,
+        'json-output': Flags.boolean({
+            char: 'j',
+            aliases: ['json'],
+            description: 'Print namespaces as JSON',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SwaggerList);
+        const response = await executeSwaggerRequest(this, flags, '/swagger:getUrls');
+        if (!response) {
+            return;
+        }
+        if (!response.ok) {
+            const details = JSON.stringify(response.data, null, 2);
+            this.error(response.status === 404
+                ? swaggerText('errors.pluginDisabled', undefined, 'The API documentation plugin is not enabled. Enable it before requesting Swagger documents.')
+                : swaggerText('errors.requestFailed', { status: response.status, details }, `Swagger request failed with status ${response.status}\n${details}`));
+        }
+        const destinations = normalizeDestinations(response.data);
+        if (!destinations) {
+            this.error(swaggerText('errors.invalidDestinations', undefined, 'swagger:getUrls returned an invalid destination list.'));
+        }
+        if (flags['json-output']) {
+            this.log(JSON.stringify(destinations, null, 2));
+            return;
+        }
+        if (!destinations.length) {
+            this.log(swaggerText('messages.empty', undefined, 'No Swagger document namespaces are available.'));
+            return;
+        }
+        this.log(renderTable([
+            swaggerText('table.name', undefined, 'Name'),
+            swaggerText('table.namespace', undefined, 'Namespace'),
+            swaggerText('table.url', undefined, 'URL'),
+        ], destinations.map((item) => [item.name, item.namespace, item.url])));
+    }
+}

package/dist/commands/config/set.js

@@ -14,6 +14,7 @@ export default class ConfigSet extends Command {
     static description = 'Set a CLI configuration value for a supported configuration key.';
     static examples = [
         '<%= config.bin %> <%= command.id %> locale zh-CN',
+        '<%= config.bin %> <%= command.id %> default-portal-template @nocobase/portal-template-default',
         '<%= config.bin %> <%= command.id %> update.policy prompt',
         '<%= config.bin %> <%= command.id %> docker.network nocobase',
         '<%= config.bin %> <%= command.id %> docker.container-prefix nb',

package/dist/commands/env/add.js

@@ -11,6 +11,7 @@ import { setCurrentEnv, upsertEnv } from '../../lib/auth-store.js';
 import { resolveDefaultConfigScope } from '../../lib/cli-home.js';
 import { ENV_BOOLEAN_CONFIG_FLAG_MAP, ENV_STRING_CONFIG_FLAG_MAP } from '../../lib/env-command-config.js';
 import { buildStoredEnvConfig } from '../../lib/env-config.js';
+import { PUBLIC_APP_CLIENT_ENTRY_MODES } from '../../lib/app-client-entry-mode.js';
 import { runPromptCatalog, } from '../../lib/prompt-catalog.js';
 import { applyCliLocale, CLI_LOCALE_FLAG_DESCRIPTION, CLI_LOCALE_FLAG_OPTIONS, localeText, } from '../../lib/cli-locale.js';
 import { validateApiBaseUrl } from '../../lib/prompt-validators.js';
@@ -172,6 +173,11 @@ export default class EnvAdd extends Command {
             hidden: true,
             description: 'Docker env file saved with this env',
         }),
+        'app-client-entry-mode': Flags.string({
+            hidden: true,
+            description: 'UI entry mode saved with this env',
+            options: [...PUBLIC_APP_CLIENT_ENTRY_MODES],
+        }),
         'app-port': Flags.string({
             hidden: true,
             description: 'Application HTTP port saved with this env',

package/dist/commands/env/update.js

@@ -16,6 +16,8 @@ import { appendDiagnosticLogPath } from '../../lib/cli-entry-error.js';
 import { getActiveCommandLogFile } from '../../lib/command-log.js';
 import { ENV_BOOLEAN_CONFIG_FLAG_MAP, ENV_STRING_CONFIG_FLAG_MAP } from '../../lib/env-command-config.js';
 import { buildStoredEnvConfig } from '../../lib/env-config.js';
+import { PUBLIC_APP_CLIENT_ENTRY_MODES } from '../../lib/app-client-entry-mode.js';
+import { upsertManagedEnvFileValues } from '../../lib/managed-env-file.js';
 import { validateApiBaseUrl } from '../../lib/prompt-validators.js';
 import { failTask, printInfo, printVerbose, printWarningBlock, setVerboseMode, startTask, stopTask, succeedTask, } from '../../lib/ui.js';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
@@ -35,6 +37,7 @@ const UPDATE_STRING_FLAGS = [
     'app-public-path',
     'cdn-base-url',
     'env-file',
+    'app-client-entry-mode',
     'app-port',
     'app-key',
     'timezone',
@@ -68,6 +71,7 @@ const APP_RESTART_FIELDS = new Set([
     'storage-path',
     'app-public-path',
     'env-file',
+    'app-client-entry-mode',
     'app-port',
     'app-key',
     'timezone',
@@ -255,6 +259,10 @@ export default class EnvUpdate extends Command {
             hidden: true,
             description: 'Saved Docker --env-file path for this env',
         }),
+        'app-client-entry-mode': Flags.string({
+            description: 'Saved UI entry mode for this env',
+            options: [...PUBLIC_APP_CLIENT_ENTRY_MODES],
+        }),
         'app-port': Flags.string({
             description: 'Saved application HTTP port for this env',
         }),
@@ -423,6 +431,11 @@ export default class EnvUpdate extends Command {
         startTask(`Saving env config: ${envName}`);
         try {
             await replaceEnvConfig(envName, nextConfig, { scope: resolveDefaultConfigScope() });
+            if (providedFields.has('app-client-entry-mode') && nextConfig.appClientEntryMode) {
+                await upsertManagedEnvFileValues(envName, nextConfig, {
+                    APP_CLIENT_ENTRY_MODE: nextConfig.appClientEntryMode,
+                });
+            }
             succeedTask(`Saved env config for "${envName}".`);
         }
         catch (error) {

package/dist/commands/init.js

@@ -13,6 +13,7 @@ import { existsSync } from 'node:fs';
 import path from 'node:path';
 import { stdin as stdinStream, stdout as stdoutStream } from 'node:process';
 import { getEnv, upsertEnv } from "../lib/auth-store.js";
+import { defaultAppClientEntryModeForDownloadVersion, normalizePublicAppClientEntryMode, PUBLIC_APP_CLIENT_ENTRY_MODES, } from '../lib/app-client-entry-mode.js';
 import { runPromptCatalog, } from "../lib/prompt-catalog.js";
 import { applyCliLocale, localeText, translateCli } from "../lib/cli-locale.js";
 import { resolveConfiguredEnvPath, resolveDefaultConfigScope, resolveEnvRelativePath } from '../lib/cli-home.js';
@@ -27,6 +28,7 @@ import { omitKeys, pickKeys } from "../lib/object-utils.js";
 import { ENV_CONFIG_SCHEMA_VERSION } from '../lib/env-config.js';
 import { printInfo, printStage, printVerbose, printWarning } from '../lib/ui.js';
 import { persistHookScript } from '../lib/hook-script.js';
+import { ensureManagedEnvFileDefaults } from '../lib/managed-env-file.js';
 import Download from "./download.js";
 import EnvAdd from "./env/add.js";
 import Install, { defaultDbPortForDialect } from "./install.js";
@@ -105,9 +107,23 @@ function resolveInitDownloadVersion(results) {
     }
     return preset;
 }
+function resolveInitAppClientEntryMode(results, explicitValue) {
+    return (normalizePublicAppClientEntryMode(explicitValue) ??
+        normalizePublicAppClientEntryMode(results.appClientEntryMode) ??
+        defaultAppClientEntryModeForDownloadVersion(resolveInitDownloadVersion(results)));
+}
 function initVersionPromptValue(version) {
     return version === 'latest' || version === 'beta' || version === 'alpha' ? version : 'other';
 }
+export function defaultInitDownloadVersionForCliVersion(cliVersion) {
+    if (/-alpha(?:[.-]|$)/i.test(cliVersion)) {
+        return 'alpha';
+    }
+    if (/-beta(?:[.-]|$)/i.test(cliVersion)) {
+        return 'beta';
+    }
+    return 'latest';
+}
 function yesInitialValue(def, fallback) {
     if ('yesInitialValue' in def && def.yesInitialValue !== undefined) {
         return String(def.yesInitialValue);
@@ -408,8 +424,15 @@ Prompt modes:
         installAccessToken: installConnectionAccessTokenPrompt,
     };
     buildPromptCatalog(flags, options) {
+        const downloadVersion = defaultInitDownloadVersionForCliVersion(String(this.config.pjson?.version ?? '').trim());
+        const versionPrompt = Init.prompts.version;
         const prompts = {
             ...Init.prompts,
+            version: {
+                ...versionPrompt,
+                initialValue: downloadVersion,
+                yesInitialValue: downloadVersion,
+            },
             installApiBaseUrl: createInstallConnectionApiBaseUrlPrompt(options.defaultApiHost),
         };
         if (flags['skip-auth']) {
@@ -473,6 +496,10 @@ Prompt modes:
             description: 'Skip installing NocoBase AI coding skills during init',
             default: false,
         }),
+        'app-client-entry-mode': Flags.string({
+            description: 'UI entry mode for this app env: modern-only, modern-default, or legacy-default',
+            options: [...PUBLIC_APP_CLIENT_ENTRY_MODES],
+        }),
         'ui-host': Flags.string({
             description: 'Browser-accessible host for the --ui setup page URL (default: 127.0.0.1)',
         }),
@@ -607,6 +634,7 @@ Prompt modes:
                     ? { setupMode: normalizeInitSetupMode(presetValues.hasNocobase) }
                     : {}),
             },
+            yesInitialValues: {},
             values: presetValues,
             yes: normalizedFlags.yes || useBrowserUi || !interactive,
             hooks: {
@@ -679,7 +707,8 @@ Prompt modes:
     }
     static async buildDynamicInitialValuesForInstall(flags, presetValues) {
         const out = {};
-        if (!Object.prototype.hasOwnProperty.call(presetValues, 'appPort')) {
+        const shouldResolveAppInitialValues = !Object.prototype.hasOwnProperty.call(presetValues, 'appPort');
+        if (shouldResolveAppInitialValues) {
             const appInitialValues = await Install.buildAppPromptInitialValues({
                 envName: String(presetValues.appName ?? '').trim(),
                 flags: {
@@ -690,7 +719,7 @@ Prompt modes:
                 },
                 warnOnPortFallback: false,
             });
-            if (appInitialValues.appPort !== undefined) {
+            if (appInitialValues.appPort !== undefined && !Object.prototype.hasOwnProperty.call(presetValues, 'appPort')) {
                 out.appPort = appInitialValues.appPort;
             }
         }
@@ -871,6 +900,9 @@ Prompt modes:
         if (flags['app-public-path'] !== undefined && String(flags['app-public-path']).trim() !== '') {
             preset.appPublicPath = String(flags['app-public-path']).trim();
         }
+        if (flags['app-client-entry-mode'] !== undefined && String(flags['app-client-entry-mode']).trim() !== '') {
+            preset.appClientEntryMode = String(flags['app-client-entry-mode']).trim();
+        }
         if (flags['root-username'] !== undefined) {
             preset.rootUsername = String(flags['root-username'] ?? '').trim();
         }
@@ -1008,6 +1040,7 @@ Prompt modes:
         const existingEnv = await getEnv(envName, { scope: resolveDefaultConfigScope() });
         const appPort = String(results.appPort ?? '').trim();
         const appPublicPath = String(results.appPublicPath ?? '').trim();
+        const appClientEntryMode = resolveInitAppClientEntryMode(results, flags['app-client-entry-mode']);
         const source = String(results.source ?? '').trim();
         const version = resolveInitDownloadVersion(results);
         const dockerRegistry = String(results.dockerRegistry ?? '').trim();
@@ -1034,7 +1067,8 @@ Prompt modes:
         const dbSchema = String(results.dbSchema ?? '').trim();
         const dbTablePrefix = String(results.dbTablePrefix ?? '').trim();
         const apiBaseUrl = String(results.apiBaseUrl ?? '').trim();
-        const authType = String(results.authType ?? '').trim() || 'oauth';
+        const authTypeInput = String(results.authType ?? '').trim();
+        const authType = authTypeInput === 'basic' || authTypeInput === 'token' || authTypeInput === 'oauth' ? authTypeInput : 'oauth';
         const authUsername = authType === 'basic' ? String(results.username ?? results.rootUsername ?? '').trim() : '';
         const accessToken = String(results.accessToken ?? '');
         const skipDownload = results.skipDownload === true;
@@ -1055,7 +1089,7 @@ Prompt modes:
                 : Boolean(results.builtinDb);
         results.appKey = appKey;
         results.timeZone = timeZone;
-        await upsertEnv(envName, {
+        const savedEnvConfig = {
             schemaVersion: ENV_CONFIG_SCHEMA_VERSION,
             ...(source === 'docker'
                 ? { kind: 'docker' }
@@ -1080,6 +1114,7 @@ Prompt modes:
             ...(storagePath && !areConfiguredPathsEquivalent(storagePath, derivedStoragePath) ? { storagePath } : {}),
             ...(appPort ? { appPort } : {}),
             ...(appPublicPath ? { appPublicPath } : {}),
+            ...(appClientEntryMode ? { appClientEntryMode } : {}),
             ...(appKey ? { appKey } : {}),
             ...(timeZone ? { timezone: timeZone } : {}),
             ...(!skipDownload && results.devDependencies !== undefined
@@ -1100,7 +1135,11 @@ Prompt modes:
             ...(results.dbUnderscored !== undefined ? { dbUnderscored: Boolean(results.dbUnderscored) } : {}),
             setupState: 'prepared',
             ...(String(results.lang ?? '').trim() ? { lang: String(results.lang ?? '').trim() } : {}),
-        }, { scope: resolveDefaultConfigScope() });
+        };
+        await upsertEnv(envName, savedEnvConfig, { scope: resolveDefaultConfigScope() });
+        if (source === 'docker' || appPath) {
+            await ensureManagedEnvFileDefaults(envName, savedEnvConfig);
+        }
     }
     buildEnvAddArgv(results) {
         const argv = [String(results.appName ?? DEFAULT_INIT_APP_NAME)];
@@ -1204,6 +1243,13 @@ Prompt modes:
         if (appPublicPath) {
             argv.push('--app-public-path', appPublicPath);
         }
+        const appClientEntryMode = normalizePublicAppClientEntryMode(flags['app-client-entry-mode']) ||
+            (results.setupMode === 'install-new' && results.hasNocobase === undefined
+                ? resolveInitAppClientEntryMode(results)
+                : undefined);
+        if (appClientEntryMode) {
+            argv.push('--app-client-entry-mode', appClientEntryMode);
+        }
         if (flags.force) {
             argv.push('--force');
         }

package/dist/commands/install.js

@@ -25,10 +25,12 @@ import { commandOutput, commandSucceeds, ensureDockerDaemonRunning, run, runNoco
 import { printInfo, printStage, printVerbose, printWarning, setVerboseMode } from '../lib/ui.js';
 import { omitKeys, upperFirst } from "../lib/object-utils.js";
 import { clearEnvRootSetup, getEnv, setCurrentEnv, upsertEnv } from '../lib/auth-store.js';
+import { defaultAppClientEntryModeForDownloadVersion, normalizePublicAppClientEntryMode, PUBLIC_APP_CLIENT_ENTRY_MODES, } from '../lib/app-client-entry-mode.js';
 import { buildStoredEnvConfig } from '../lib/env-config.js';
 import { resolveDockerEnvFileArg } from "../lib/docker-env-file.js";
 import { startDockerLogFollower } from '../lib/docker-log-stream.js';
 import { buildInitAppEnvVarsFromConfig } from '../lib/managed-init-env.js';
+import { ensureManagedEnvFileDefaults } from '../lib/managed-env-file.js';
 import { buildHookContext, persistHookScript, resolveHookScriptPath, runHookScriptHook, } from '../lib/hook-script.js';
 import { areConfiguredPathsEquivalent, deriveConfiguredSourcePath, deriveConfiguredStoragePath, inferConfiguredAppPathFromLegacyConfig, } from '../lib/env-paths.js';
 import Download from './download.js';
@@ -53,6 +55,7 @@ const DEFAULT_INSTALL_ROOT_EMAIL = 'admin@nocobase.com';
 const DEFAULT_INSTALL_ROOT_PASSWORD = 'admin123';
 const DEFAULT_INSTALL_ROOT_NICKNAME = 'Super Admin';
 const DEFAULT_INSTALL_API_HOST = '127.0.0.1';
+const DEFAULT_INSTALL_PORTAL_TEMPLATE = '@nocobase/portal-template-default';
 function toOptionalPromptString(value) {
     const text = String(value ?? '').trim();
     return text || undefined;
@@ -404,6 +407,13 @@ export default class Install extends Command {
         'app-public-path': Flags.string({
             description: 'Public path for the local app, for example / or /console/',
         }),
+        'app-client-entry-mode': Flags.string({
+            description: 'UI entry mode for this app env: modern-only, modern-default, or legacy-default',
+            options: [...PUBLIC_APP_CLIENT_ENTRY_MODES],
+        }),
+        'portal-template': Flags.string({
+            description: 'Template npm package or local path for the default AI Portal "main"',
+        }),
         'root-username': Flags.string({
             description: 'Initial admin username for the installed app',
             required: false,
@@ -513,6 +523,14 @@ export default class Install extends Command {
                 yesInitialValue: '/',
                 validate: validateAppPublicPath,
             },
+            portalTemplate: {
+                type: 'text',
+                message: installText('prompts.portalTemplate.message'),
+                placeholder: DEFAULT_INSTALL_PORTAL_TEMPLATE,
+                initialValue: DEFAULT_INSTALL_PORTAL_TEMPLATE,
+                yesInitialValue: DEFAULT_INSTALL_PORTAL_TEMPLATE,
+                required: true,
+            },
         };
     }
     static dbPrompts = {
@@ -772,6 +790,18 @@ export default class Install extends Command {
                 preset.appPublicPath = v;
             }
         }
+        if (flags['app-client-entry-mode'] !== undefined) {
+            const v = normalizePublicAppClientEntryMode(flags['app-client-entry-mode']);
+            if (v) {
+                preset.appClientEntryMode = v;
+            }
+        }
+        if (flags['portal-template'] !== undefined) {
+            const v = String(flags['portal-template'] ?? '').trim();
+            if (v) {
+                preset.portalTemplate = v;
+            }
+        }
         if (flags['root-username'] !== undefined) {
             preset.rootUsername = String(flags['root-username'] ?? '').trim();
         }
@@ -863,6 +893,8 @@ export default class Install extends Command {
             'appPort',
             'storagePath',
             'appPublicPath',
+            'appClientEntryMode',
+            'portalTemplate',
         ]);
     }
     static buildDbPresetValuesFromFlags(flags, argv = process.argv.slice(2)) {
@@ -1112,6 +1144,7 @@ export default class Install extends Command {
         const rootPassword = Install.toOptionalPromptString(config.rootPassword);
         const rootNickname = Install.toOptionalPromptString(config.rootNickname);
         const lang = Install.toOptionalPromptString(config.lang);
+        const portalTemplate = Install.toOptionalPromptString(config.portalTemplate);
         const auth = config.auth;
         const savedAuthType = Install.toOptionalPromptString(config.authType) ?? Install.toOptionalPromptString(auth?.type);
         const appPreset = {
@@ -1121,6 +1154,7 @@ export default class Install extends Command {
             ...(appPort ? { appPort } : {}),
             ...(storagePath ? { storagePath } : {}),
             ...(appPublicPath ? { appPublicPath } : {}),
+            ...(portalTemplate ? { portalTemplate } : {}),
             ...(hookScript ? { hookScript } : {}),
         };
         const downloadPreset = {
@@ -1263,6 +1297,12 @@ export default class Install extends Command {
                 warn: params.warnOnPortFallback ?? true,
             });
         }
+        if (params.flags['portal-template'] === undefined) {
+            const defaultPortalTemplate = Install.toOptionalPromptString(await getCliConfigValue('default-portal-template'));
+            if (defaultPortalTemplate) {
+                initialValues.portalTemplate = defaultPortalTemplate;
+            }
+        }
         return initialValues;
     }
     static shouldPublishBuiltinDbPortForValues(values) {
@@ -1430,14 +1470,15 @@ export default class Install extends Command {
     static buildDockerAppContainerName(envName, containerPrefix) {
         return Install.sanitizeDockerResourceName(`${Install.buildBuiltinDbContainerPrefix(containerPrefix)}-${envName}-app`);
     }
-    static buildInitAppEnvVars(params) {
+    static buildInitAppEnvVars(params, options = {}) {
         return buildInitAppEnvVarsFromConfig({
             lang: String(params.appResults.lang ?? ''),
             rootUsername: String(params.rootResults.rootUsername ?? ''),
             rootEmail: String(params.rootResults.rootEmail ?? ''),
             rootPassword: String(params.rootResults.rootPassword ?? ''),
             rootNickname: String(params.rootResults.rootNickname ?? ''),
-        });
+            portalTemplate: String(params.appResults.portalTemplate ?? ''),
+        }, options);
     }
     static shouldPublishBuiltinDbPort(source) {
         return String(source ?? '').trim() !== 'docker';
@@ -1785,6 +1826,7 @@ export default class Install extends Command {
         const extractClientAssets = resolveExtractClientAssetsDefaultEnabled(process.env.NOCOBASE_EXTRACT_CLIENT_ASSETS);
         const appKey = Install.resolveManagedAppKey(params.appResults.appKey);
         const appPublicPath = Install.toOptionalPromptString(params.appResults.appPublicPath);
+        const appClientEntryMode = Install.toOptionalPromptString(params.appResults.appClientEntryMode);
         const timeZone = Install.resolveManagedTimeZone(params.appResults.timeZone);
         const containerName = Install.buildDockerAppContainerName(params.envName, params.dockerContainerPrefix ?? params.workspaceName);
         const configuredEnvFile = String(params.appResults.envFile ?? '').trim();
@@ -1812,6 +1854,7 @@ export default class Install extends Command {
         }
         args.push('-e', `APP_KEY=${appKey}`, '-e', `DB_DIALECT=${dbDialect}`, '-e', `DB_HOST=${dbHost}`, '-e', `DB_PORT=${dbPort}`, '-e', `DB_DATABASE=${dbDatabase}`, '-e', `DB_USER=${dbUser}`, '-e', `DB_PASSWORD=${dbPassword}`, '-e', `TZ=${timeZone}`, '-v', `${storagePath}:/app/nocobase/storage`);
         pushOptionalEnvArg(args, 'APP_PUBLIC_PATH', appPublicPath);
+        pushOptionalEnvArg(args, 'APP_CLIENT_ENTRY_MODE', appClientEntryMode);
         pushOptionalEnvArg(args, 'DB_SCHEMA', dbSchema);
         pushOptionalEnvArg(args, 'DB_TABLE_PREFIX', dbTablePrefix);
         pushOptionalEnvArg(args, 'DB_UNDERSCORED', dbUnderscored);
@@ -2072,6 +2115,7 @@ export default class Install extends Command {
             }),
         };
         setOptionalEnvVar(env, 'APP_PUBLIC_PATH', Install.toOptionalPromptString(params.appResults.appPublicPath));
+        setOptionalEnvVar(env, 'APP_CLIENT_ENTRY_MODE', Install.toOptionalPromptString(params.appResults.appClientEntryMode));
         setOptionalEnvVar(env, 'DB_SCHEMA', optionalEnvString(params.dbResults.dbSchema));
         setOptionalEnvVar(env, 'DB_TABLE_PREFIX', optionalEnvString(params.dbResults.dbTablePrefix));
         setOptionalEnvVar(env, 'DB_UNDERSCORED', optionalEnvBoolean(params.dbResults.dbUnderscored));
@@ -2228,9 +2272,13 @@ export default class Install extends Command {
     }
     async saveInstalledEnv(params) {
         const defaultApiHost = await resolveDefaultApiHost();
-        await upsertEnv(params.envName, Install.buildSavedEnvConfig(params, { defaultApiHost }), {
+        const savedEnvConfig = Install.buildSavedEnvConfig(params, { defaultApiHost });
+        await upsertEnv(params.envName, savedEnvConfig, {
             scope: resolveDefaultConfigScope(),
         });
+        if (params.ensureEnvFileDefaults !== false) {
+            await ensureManagedEnvFileDefaults(params.envName, savedEnvConfig);
+        }
         await setCurrentEnv(params.envName, { scope: resolveDefaultConfigScope() });
     }
     async syncInstalledEnvConnection(params) {
@@ -2309,6 +2357,8 @@ export default class Install extends Command {
         const appRootPath = Install.toOptionalPromptString(params.appResults.appRootPath);
         const storagePath = Install.toOptionalPromptString(params.appResults.storagePath);
         const appPublicPath = Install.toOptionalPromptString(params.appResults.appPublicPath);
+        const appClientEntryMode = Install.toOptionalPromptString(params.appResults.appClientEntryMode);
+        const portalTemplate = Install.toOptionalPromptString(params.appResults.portalTemplate);
         const derivedAppRootPath = appPath ? deriveConfiguredSourcePath(appPath) : undefined;
         const derivedStoragePath = appPath ? deriveConfiguredStoragePath(appPath) : undefined;
         const appPort = String(params.appResults.appPort ?? DEFAULT_INSTALL_APP_PORT).trim() || DEFAULT_INSTALL_APP_PORT;
@@ -2341,8 +2391,10 @@ export default class Install extends Command {
             appPort,
             ...(storagePath && !areConfiguredPathsEquivalent(storagePath, derivedStoragePath) ? { storagePath } : {}),
             ...(appPublicPath ? { appPublicPath } : {}),
+            ...(appClientEntryMode ? { appClientEntryMode } : {}),
             ...(envFile ? { envFile } : {}),
             lang: params.appResults.lang,
+            portalTemplate,
             appKey: params.appResults.appKey,
             timezone: params.appResults.timeZone,
             builtinDb: params.dbResults.builtinDb,
@@ -2394,6 +2446,7 @@ export default class Install extends Command {
                     'app-root-path': parsed['app-root-path'] ?? Install.toOptionalPromptString(appPreset.appRootPath),
                     'app-port': parsed['app-port'] ?? Install.toOptionalPromptString(appPreset.appPort),
                     'storage-path': parsed['storage-path'] ?? Install.toOptionalPromptString(appPreset.storagePath),
+                    'portal-template': parsed['portal-template'] ?? Install.toOptionalPromptString(appPreset.portalTemplate),
                 },
             }),
             values: appPreset,
@@ -2412,6 +2465,9 @@ export default class Install extends Command {
         };
         downloadOpts.yes = yes;
         const downloadResults = await runPromptCatalog(Download.prompts, downloadOpts);
+        appResults.appClientEntryMode =
+            normalizePublicAppClientEntryMode(appResults.appClientEntryMode) ??
+                defaultAppClientEntryModeForDownloadVersion(downloadResultsValue(downloadResults, 'version'));
         if (parsed['skip-download']) {
             delete downloadResults.outputDir;
             delete downloadResults.replace;
@@ -2565,6 +2621,7 @@ export default class Install extends Command {
                 dbResults,
                 rootResults,
                 envAddResults,
+                ensureEnvFileDefaults: false,
             });
             if (!parsed['skip-save-env-log']) {
                 printInfo(`Saved env config for "${envName}".`);