@nocobase/cli 2.1.0-alpha.21 → 2.1.0-alpha.22

package/dist/commands/download.js

@@ -12,11 +12,13 @@ import * as p from '@clack/prompts';
 import path from 'node:path';
 import { stdin as stdinStream, stdout as stdoutStream } from 'node:process';
 import { runPromptCatalog, } from "../lib/prompt-catalog.js";
+import { applyCliLocale, CLI_LOCALE_FLAG_DESCRIPTION, CLI_LOCALE_FLAG_OPTIONS, localeText, } from "../lib/cli-locale.js";
 import { run } from "../lib/run-npm.js";
 import { printVerbose, setVerboseMode, startTask, stopTask, updateTask } from '../lib/ui.js';
 const DEFAULT_DOCKER_REGISTRY = 'nocobase/nocobase';
 const DEFAULT_DOCKER_REGISTRY_ZH_CN = 'registry.cn-shanghai.aliyuncs.com/nocobase/nocobase';
 const DEFAULT_DOCKER_PLATFORM = 'auto';
+const downloadText = (key, values) => localeText(`commands.download.${key}`, values);
 function defaultOutputDirForVersion(versionTag) {
     const safe = versionTag.replace(/[/\\]/g, '-');
     return `./nocobase-${safe}`;
@@ -109,6 +111,10 @@ export default class Download extends Command {
             description: 'Show detailed command output',
             default: false,
         }),
+        locale: Flags.string({
+            description: CLI_LOCALE_FLAG_DESCRIPTION,
+            options: CLI_LOCALE_FLAG_OPTIONS,
+        }),
         'no-intro': Flags.boolean({
             hidden: true,
             description: 'Skip command intro when invoked by another CLI command',
@@ -143,7 +149,7 @@ export default class Download extends Command {
             description: 'Git repository URL to clone when --source git is used.',
         }),
         'docker-registry': Flags.string({
-            description: 'Docker image repository to pull when --source docker is used.',
+            description: 'Docker registry to pull when --source docker is used; combine it with --version as the image tag.',
         }),
         'docker-platform': Flags.string({
             description: 'Docker image platform to pull; use auto to let Docker choose.',
@@ -170,11 +176,11 @@ export default class Download extends Command {
     static prompts = {
         source: {
             type: 'select',
-            message: 'How would you like to get NocoBase?',
+            message: downloadText('prompts.source.message'),
             options: [
-                { value: 'npm', label: 'NPM package' },
-                { value: 'git', label: 'Git repository' },
-                { value: 'docker', label: 'Docker image' },
+                { value: 'npm', label: downloadText('prompts.source.npmLabel') },
+                { value: 'git', label: downloadText('prompts.source.gitLabel') },
+                { value: 'docker', label: downloadText('prompts.source.dockerLabel') },
             ],
             yesInitialValue: 'docker',
             initialValue: 'docker',
@@ -182,16 +188,16 @@ export default class Download extends Command {
         },
         version: {
             type: 'text',
-            message: 'Which version would you like to use? You can enter a package version, Docker image tag, or Git ref such as a branch name.',
-            placeholder: 'alpha',
+            message: downloadText('prompts.version.message'),
+            placeholder: downloadText('prompts.version.placeholder'),
             initialValue: 'alpha',
             yesInitialValue: 'alpha',
             required: true,
         },
         dockerRegistry: {
             type: 'text',
-            message: 'Which Docker image would you like to use?',
-            placeholder: DEFAULT_DOCKER_REGISTRY,
+            message: downloadText('prompts.dockerRegistry.message'),
+            placeholder: downloadText('prompts.dockerRegistry.placeholder'),
             initialValue: (values) => defaultDockerRegistryForLang(values.lang),
             yesInitialValue: DEFAULT_DOCKER_REGISTRY,
             required: true,
@@ -199,9 +205,13 @@ export default class Download extends Command {
         },
         dockerPlatform: {
             type: 'select',
-            message: 'Which Docker image platform should be used?',
+            message: downloadText('prompts.dockerPlatform.message'),
             options: [
-                { value: 'auto', label: 'Auto', hint: 'Use Docker default for this machine' },
+                {
+                    value: 'auto',
+                    label: downloadText('prompts.dockerPlatform.autoLabel'),
+                    hint: downloadText('prompts.dockerPlatform.autoHint'),
+                },
                 { value: 'linux/amd64', label: 'linux/amd64' },
                 { value: 'linux/arm64', label: 'linux/arm64' },
             ],
@@ -212,14 +222,14 @@ export default class Download extends Command {
         },
         dockerSave: {
             type: 'boolean',
-            message: 'Save the Docker image as a tar file',
+            message: downloadText('prompts.dockerSave.message'),
             initialValue: false,
             hidden: (values) => values.source !== 'docker',
         },
         gitUrl: {
             type: 'text',
-            message: 'Git repository URL',
-            placeholder: 'https://github.com/nocobase/nocobase.git',
+            message: downloadText('prompts.gitUrl.message'),
+            placeholder: downloadText('prompts.gitUrl.placeholder'),
             initialValue: 'https://github.com/nocobase/nocobase.git',
             yesInitialValue: 'https://github.com/nocobase/nocobase.git',
             required: true,
@@ -227,8 +237,8 @@ export default class Download extends Command {
         },
         outputDir: {
             type: 'text',
-            message: 'Download location',
-            placeholder: 'e.g. ./nocobase-latest',
+            message: downloadText('prompts.outputDir.message'),
+            placeholder: downloadText('prompts.outputDir.placeholder'),
             initialValue: (values) => defaultOutputDirForVersion(String(values.version ?? 'latest').trim() || 'latest'),
             required: true,
             hidden: (values) => {
@@ -244,33 +254,33 @@ export default class Download extends Command {
         },
         npmRegistry: {
             type: 'text',
-            message: 'NPM registry URL (optional)',
-            placeholder: 'Leave empty to use the default registry',
+            message: downloadText('prompts.npmRegistry.message'),
+            placeholder: downloadText('prompts.npmRegistry.placeholder'),
             initialValue: '',
             hidden: (values) => values.source !== 'npm' && values.source !== 'git',
         },
         replace: {
             type: 'boolean',
-            message: 'Clear the app directory if it already contains files',
+            message: downloadText('prompts.replace.message'),
             initialValue: false,
             hidden: (values) => Download.hideOutputDirAndReplaceSteps(values),
         },
         devDependencies: {
             type: 'boolean',
-            message: 'Install development dependencies (npm only)',
+            message: downloadText('prompts.devDependencies.message'),
             initialValue: false,
             hidden: (values) => values.source !== 'npm',
         },
         build: {
             type: 'boolean',
-            message: 'Build the app after download',
+            message: downloadText('prompts.build.message'),
             initialValue: true,
             yesInitialValue: true,
             hidden: () => true,
         },
         buildDts: {
             type: 'boolean',
-            message: 'Generate TypeScript declaration files',
+            message: downloadText('prompts.buildDts.message'),
             initialValue: false,
             hidden: (values) => values.source !== 'git',
         },
@@ -689,6 +699,7 @@ export default class Download extends Command {
     async download() {
         const { flags } = await this.parse(Download);
         this._flags = flags;
+        applyCliLocale(this._flags.locale);
         setVerboseMode(Boolean(flags.verbose));
         if (!flags['no-intro']) {
             p.intro('Get NocoBase');

package/dist/commands/env/add.js

@@ -9,6 +9,7 @@
 import { Args, Command, Flags } from '@oclif/core';
 import { upsertEnv } from '../../lib/auth-store.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';
 import { printVerbose, setVerboseMode } from '../../lib/ui.js';
 import * as p from '@clack/prompts';
@@ -25,6 +26,7 @@ const ENV_RUNTIME_FLAG_MAP = {
     'app-key': 'appKey',
     timezone: 'timezone',
     'db-dialect': 'dbDialect',
+    'builtin-db-image': 'builtinDbImage',
     'db-host': 'dbHost',
     'db-port': 'dbPort',
     'db-database': 'dbDatabase',
@@ -37,6 +39,7 @@ const ENV_BOOLEAN_RUNTIME_FLAG_MAP = {
     build: 'build',
     'build-dts': 'buildDts',
 };
+const envAddText = (key, values) => localeText(`commands.envAdd.${key}`, values);
 export default class EnvAdd extends Command {
     static summary = 'Save a named NocoBase API endpoint (token or OAuth), then switch the CLI to use it';
     static examples = [
@@ -61,6 +64,10 @@ export default class EnvAdd extends Command {
             description: 'Print detailed progress while writing config',
             default: false,
         }),
+        locale: Flags.string({
+            description: CLI_LOCALE_FLAG_DESCRIPTION,
+            options: CLI_LOCALE_FLAG_OPTIONS,
+        }),
         'no-intro': Flags.boolean({
             hidden: true,
             description: 'Skip command intro when invoked by another CLI command',
@@ -160,6 +167,10 @@ export default class EnvAdd extends Command {
             hidden: true,
             description: 'Database dialect saved with this env',
         }),
+        'builtin-db-image': Flags.string({
+            hidden: true,
+            description: 'Built-in database image saved with this env',
+        }),
         'db-host': Flags.string({
             hidden: true,
             description: 'Database host saved with this env',
@@ -184,41 +195,53 @@ export default class EnvAdd extends Command {
     static prompts = {
         name: {
             type: 'text',
-            message: 'What would you like to call this environment?',
-            placeholder: 'default',
+            message: envAddText('prompts.name.message'),
+            placeholder: envAddText('prompts.name.placeholder'),
             required: true,
         },
         scope: {
             type: 'select',
-            message: 'Where should this connection be saved?',
+            message: envAddText('prompts.scope.message'),
             options: [
-                { value: 'project', label: 'Project', hint: '.nocobase in this repo' },
-                { value: 'global', label: 'Global', hint: 'user-level config' },
+                {
+                    value: 'project',
+                    label: envAddText('prompts.scope.projectLabel'),
+                    hint: envAddText('prompts.scope.projectHint'),
+                },
+                {
+                    value: 'global',
+                    label: envAddText('prompts.scope.globalLabel'),
+                    hint: envAddText('prompts.scope.globalHint'),
+                },
             ],
             initialValue: 'project',
             required: true,
         },
         apiBaseUrl: {
             type: 'text',
-            message: 'What is the API base URL?',
-            placeholder: 'http://localhost:13000/api',
+            message: envAddText('prompts.apiBaseUrl.message'),
+            placeholder: envAddText('prompts.apiBaseUrl.placeholder'),
             required: true,
             validate: validateApiBaseUrl,
         },
         authType: {
             type: 'select',
-            message: 'How would you like to sign in?',
+            message: envAddText('prompts.authType.message'),
             options: [
-                { value: 'oauth', label: 'OAuth (browser login)', hint: 'runs nb env auth after save' },
-                { value: 'token', label: 'API token / API key' },
+                {
+                    value: 'oauth',
+                    label: envAddText('prompts.authType.oauthLabel'),
+                    hint: envAddText('prompts.authType.oauthHint'),
+                },
+                { value: 'token', label: envAddText('prompts.authType.tokenLabel') },
             ],
             initialValue: 'oauth',
             required: true,
         },
         accessToken: {
             type: 'text',
-            message: 'Enter an API token or API key',
-            placeholder: 'Enter your API token / API key',
+            message: envAddText('prompts.accessToken.message'),
+            placeholder: envAddText('prompts.accessToken.placeholder'),
             required: true,
             hidden: (values) => values.authType !== 'token',
         },
@@ -269,6 +292,9 @@ export default class EnvAdd extends Command {
                 envConfig[configKey] = value;
             }
         }
+        if (flags['builtin-db'] === false) {
+            envConfig.builtinDbImage = undefined;
+        }
         if (results.authType === 'token' && results.accessToken != null) {
             envConfig.accessToken = String(results.accessToken);
         }
@@ -277,6 +303,7 @@ export default class EnvAdd extends Command {
     async run() {
         const { args, flags } = await this.parse(EnvAdd);
         const parsedFlags = flags;
+        applyCliLocale(parsedFlags.locale);
         setVerboseMode(parsedFlags.verbose);
         if (!parsedFlags['no-intro']) {
             p.intro('Connect a NocoBase Environment');

package/dist/commands/init.js

@@ -14,6 +14,7 @@ import path from 'node:path';
 import { stdin as stdinStream, stdout as stdoutStream } from 'node:process';
 import { getEnv, upsertEnv } from "../lib/auth-store.js";
 import { runPromptCatalog, } from "../lib/prompt-catalog.js";
+import { applyCliLocale, localeText, translateCli } from "../lib/cli-locale.js";
 import { runPromptCatalogWebUI, } from "../lib/prompt-web-ui.js";
 import { validateApiBaseUrl, validateEnvKey } from "../lib/prompt-validators.js";
 import { run } from "../lib/run-npm.js";
@@ -25,6 +26,7 @@ const DEFAULT_INIT_API_BASE_URL = 'http://localhost:13000/api';
 const DEFAULT_INIT_APP_NAME = 'local';
 const DOWNLOAD_OUTPUT_DIR_PROMPT = Download.prompts.outputDir;
 const CONFIG_SCOPE = 'project';
+const initText = (key, values) => localeText(`commands.init.${key}`, values);
 function withExtraHidden(def, extraHidden) {
     if (def.type === 'run') {
         return def;
@@ -63,7 +65,7 @@ async function validateInitAppName(value) {
         if (shouldAllowExistingInitEnv()) {
             return undefined;
         }
-        return `Env "${envName}" already exists in this workspace. Choose another app name.`;
+        return translateCli('commands.init.validation.envExists', { envName });
     }
     return undefined;
 }
@@ -71,20 +73,31 @@ function highlightInitValidationMessage(message) {
     return message.replace(/Env "([^"]+)"/, (_match, envName) => `Env ${pc.cyan(pc.bold(`"${envName}"`))}`);
 }
 function formatInitValidationMessage(message) {
-    if (/"appName" is required/.test(message)) {
-        return [
-            'App name is required when prompts are skipped.',
-            'The app name is also the CLI env name. Use `nb init --yes --env <envName>` to continue.',
-        ].join('\n');
-    }
     return message;
 }
 function formatResumeEnvRequiredMessage() {
     return [
-        'Env name is required when resuming setup.',
-        'App name is also the CLI env name. Use `nb init --resume --env <envName>` to continue.',
+        translateCli('commands.init.messages.resumeEnvRequired'),
+        translateCli('commands.init.messages.resumeEnvHelp'),
     ].join('\n');
 }
+function formatSkippedAppNameRequiredMessage() {
+    return [
+        translateCli('commands.init.messages.appNameRequiredWhenSkipped'),
+        translateCli('commands.init.messages.appNameEnvHelp'),
+    ].join('\n');
+}
+function initTitle() {
+    return translateCli('commands.init.messages.title');
+}
+function logInitUiReady(command, url) {
+    p.log.step(translateCli('commands.init.messages.uiReady'));
+    p.log.info(translateCli('commands.init.messages.uiReadyHelp'));
+    command.log(`URL: ${url}`);
+}
+function logInitUiBrowserOpenFallback() {
+    p.log.warn(translateCli('commands.init.messages.uiOpenBrowserFallback'));
+}
 export default class Init extends Command {
     static summary = 'Set up NocoBase so coding agents can connect and work with it';
     static description = `Set up NocoBase for coding agents in the current workspace.
@@ -119,23 +132,23 @@ Prompt modes:
     static prompts = {
         appName: {
             type: 'text',
-            message: 'App name (also used as the CLI env name)',
-            placeholder: DEFAULT_INIT_APP_NAME,
+            message: initText('prompts.appName.message'),
+            placeholder: initText('prompts.appName.placeholder'),
             required: true,
             validate: validateInitAppName,
         },
         hasNocobase: {
             type: 'select',
             variant: 'radio',
-            message: 'Do you already have a NocoBase application?',
+            message: initText('prompts.hasNocobase.message'),
             options: [
                 {
                     value: 'no',
-                    label: "I don't have a NocoBase application yet",
+                    label: initText('prompts.hasNocobase.noLabel'),
                 },
                 {
                     value: 'yes',
-                    label: 'I already have a NocoBase application',
+                    label: initText('prompts.hasNocobase.yesLabel'),
                 },
             ],
             initialValue: 'no',
@@ -144,14 +157,14 @@ Prompt modes:
         },
         installSkills: {
             type: 'boolean',
-            message: 'Install NocoBase AI coding skills (nocobase/skills)?',
+            message: initText('prompts.installSkills.message'),
             initialValue: true,
             yesInitialValue: true,
         },
         apiBaseUrl: existingAppOnly({
             type: 'text',
-            message: 'API base URL',
-            placeholder: DEFAULT_INIT_API_BASE_URL,
+            message: initText('prompts.apiBaseUrl.message'),
+            placeholder: initText('prompts.apiBaseUrl.placeholder'),
             required: true,
             validate: validateApiBaseUrl,
         }),
@@ -194,8 +207,9 @@ Prompt modes:
         devDependencies: downloadInNewInstallOnly(Download.prompts.devDependencies),
         build: downloadInNewInstallOnly(Download.prompts.build),
         buildDts: downloadInNewInstallOnly(Download.prompts.buildDts),
-        builtinDb: newInstallOnly(Install.dbPrompts.builtinDb),
         dbDialect: newInstallOnly(Install.dbPrompts.dbDialect),
+        builtinDb: newInstallOnly(Install.dbPrompts.builtinDb),
+        builtinDbImage: newInstallOnly(Install.dbPrompts.builtinDbImage),
         dbHost: newInstallOnly(Install.dbPrompts.dbHost),
         dbPort: newInstallOnly(Install.dbPrompts.dbPort),
         dbDatabase: newInstallOnly(Install.dbPrompts.dbDatabase),
@@ -209,12 +223,12 @@ Prompt modes:
     static flags = {
         yes: Flags.boolean({
             char: 'y',
-            description: 'Skip prompts and create a new local NocoBase app. Requires an app/env name.',
+            description: 'Skip prompts and create a new local NocoBase app. Requires an env name.',
             default: false,
         }),
         env: Flags.string({
             char: 'e',
-            description: 'App name / CLI env name for this setup. Required with --yes and --resume',
+            description: 'Env name for this setup. Required with --yes and --resume',
         }),
         'install-skills': Flags.boolean({
             description: 'Install NocoBase AI coding skills (`nocobase/skills`) for this workspace',
@@ -236,6 +250,7 @@ Prompt modes:
     };
     async run() {
         const parsedResult = await this.parse(Init);
+        applyCliLocale(parsedResult.flags.locale);
         const flags = parsedResult.flags;
         const normalizedFlags = { ...flags };
         if (normalizedFlags.ui && normalizedFlags.yes) {
@@ -254,7 +269,7 @@ Prompt modes:
                 p.log.error(formatResumeEnvRequiredMessage());
                 this.exit(1);
             }
-            p.intro('Set Up NocoBase for Coding Agents');
+            p.intro(initTitle());
             if (Boolean(normalizedFlags['install-skills'])) {
                 try {
                     p.log.step('Installing NocoBase agent skills (npx -y skills add nocobase/skills)');
@@ -282,17 +297,17 @@ Prompt modes:
         const useBrowserUi = Boolean(normalizedFlags.ui);
         let presetValues = this.buildPresetValuesFromFlags(normalizedFlags);
         if (normalizedFlags.yes && !String(presetValues.appName ?? '').trim()) {
-            const formatted = formatInitValidationMessage('Non-interactive: "appName" is required; set initialValues.appName, yesInitialValues.appName, yesInitialValue on the block, or initialValue.');
+            const formatted = formatSkippedAppNameRequiredMessage();
             p.log.error(highlightInitValidationMessage(formatted));
             this.exit(1);
         }
         const appName = String(presetValues.appName ?? '').trim();
         if (useBrowserUi) {
-            p.intro('Set Up NocoBase for Coding Agents');
-            p.log.info('A local setup form will open in your browser. Submit the form there to continue in this terminal.');
+            p.intro(initTitle());
+            p.log.info(translateCli('commands.init.messages.uiOpening'));
         }
         else {
-            p.intro('Set Up NocoBase for Coding Agents');
+            p.intro(initTitle());
             if (normalizedFlags.yes) {
                 p.log.info(`Prompts skipped (--yes). NocoBase will be installed for env "${appName}" using the provided flags and safe defaults.`);
             }
@@ -310,14 +325,14 @@ Prompt modes:
                 },
                 host: normalizedFlags['ui-host']?.trim() || '127.0.0.1',
                 port: normalizedFlags['ui-port'] ?? 0,
-                pageTitle: 'Set Up NocoBase for Coding Agents',
-                documentHeading: 'Set Up NocoBase for Coding Agents',
-                documentHint: 'Connect an existing NocoBase app or install a new one, then save it as an agent-ready CLI environment.',
-                onServerStart: ({ host, port, url }) => {
-                    this.log(`Local setup form ready at ${url} (listening on ${host}:${port}). Submit it in your browser to continue here.`);
+                pageTitle: initText('webUi.pageTitle'),
+                documentHeading: initText('webUi.documentHeading'),
+                documentHint: initText('webUi.documentHint'),
+                onServerStart: ({ url }) => {
+                    logInitUiReady(this, url);
                 },
-                onOpenBrowserError: (url, err) => {
-                    this.log(`Open this URL in your browser to continue setup: ${url} (${err instanceof Error ? err.message : String(err)})`);
+                onOpenBrowserError: (_url, _err) => {
+                    logInitUiBrowserOpenFallback();
                 },
             });
         }
@@ -390,6 +405,7 @@ Prompt modes:
                     'app-root-path': flags['app-root-path'] ?? '',
                     'storage-path': flags['storage-path'] ?? '',
                 },
+                warnOnPortFallback: false,
             });
             if (appInitialValues.appPort !== undefined) {
                 out.appPort = appInitialValues.appPort;
@@ -405,6 +421,7 @@ Prompt modes:
             flags,
             downloadResults: downloadSeed,
             dbPreset: presetValues,
+            warnOnPortFallback: false,
         });
         for (const [key, value] of Object.entries(dbInitial)) {
             if (!Object.prototype.hasOwnProperty.call(presetValues, key)) {
@@ -417,8 +434,8 @@ Prompt modes:
         const c = Init.prompts;
         return [
             {
-                sectionTitle: 'Getting started',
-                sectionDescription: 'Pick your setup path.',
+                sectionTitle: initText('webUi.gettingStarted.title'),
+                sectionDescription: initText('webUi.gettingStarted.description'),
                 catalog: {
                     appName: c.appName,
                     hasNocobase: c.hasNocobase,
@@ -426,8 +443,8 @@ Prompt modes:
                 },
             },
             {
-                sectionTitle: 'Connect an existing app',
-                sectionDescription: 'Add your app connection.',
+                sectionTitle: initText('webUi.connectExistingApp.title'),
+                sectionDescription: initText('webUi.connectExistingApp.description'),
                 catalog: {
                     apiBaseUrl: c.apiBaseUrl,
                     authType: c.authType,
@@ -435,8 +452,8 @@ Prompt modes:
                 },
             },
             {
-                sectionTitle: 'Create a new app',
-                sectionDescription: 'Set project basics.',
+                sectionTitle: initText('webUi.createNewApp.title'),
+                sectionDescription: initText('webUi.createNewApp.description'),
                 catalog: {
                     lang: c.lang,
                     appRootPath: c.appRootPath,
@@ -446,8 +463,8 @@ Prompt modes:
                 },
             },
             {
-                sectionTitle: 'Download app files',
-                sectionDescription: 'Choose source and options.',
+                sectionTitle: initText('webUi.downloadAppFiles.title'),
+                sectionDescription: initText('webUi.downloadAppFiles.description'),
                 catalog: {
                     source: c.source,
                     version: c.version,
@@ -464,11 +481,12 @@ Prompt modes:
                 },
             },
             {
-                sectionTitle: 'Configure the database',
-                sectionDescription: 'Use built-in or custom.',
+                sectionTitle: initText('webUi.configureDatabase.title'),
+                sectionDescription: initText('webUi.configureDatabase.description'),
                 catalog: {
-                    builtinDb: c.builtinDb,
                     dbDialect: c.dbDialect,
+                    builtinDb: c.builtinDb,
+                    builtinDbImage: c.builtinDbImage,
                     dbHost: c.dbHost,
                     dbPort: c.dbPort,
                     dbDatabase: c.dbDatabase,
@@ -477,8 +495,8 @@ Prompt modes:
                 },
             },
             {
-                sectionTitle: 'Create an admin account',
-                sectionDescription: 'Set up the first admin.',
+                sectionTitle: initText('webUi.createAdminAccount.title'),
+                sectionDescription: initText('webUi.createAdminAccount.description'),
                 catalog: {
                     rootUsername: c.rootUsername,
                     rootEmail: c.rootEmail,
@@ -521,6 +539,9 @@ Prompt modes:
         if (flags['db-dialect'] !== undefined && String(flags['db-dialect']).trim() !== '') {
             preset.dbDialect = String(flags['db-dialect']).trim();
         }
+        if (flags['builtin-db-image'] !== undefined && String(flags['builtin-db-image']).trim() !== '') {
+            preset.builtinDbImage = String(flags['builtin-db-image']).trim();
+        }
         if (flags['db-host'] !== undefined && String(flags['db-host']).trim() !== '') {
             preset.dbHost = String(flags['db-host']).trim();
         }
@@ -601,6 +622,7 @@ Prompt modes:
         const appRootPath = String(results.appRootPath ?? '').trim();
         const storagePath = String(results.storagePath ?? '').trim();
         const dbDialect = String(results.dbDialect ?? '').trim();
+        const builtinDbImage = String(results.builtinDbImage ?? '').trim();
         const dbHost = String(results.dbHost ?? '').trim();
         const dbPort = String(results.dbPort ?? '').trim();
         const dbDatabase = String(results.dbDatabase ?? '').trim();
@@ -622,6 +644,7 @@ Prompt modes:
             ...(results.buildDts !== undefined ? { buildDts: Boolean(results.buildDts) } : {}),
             ...(results.builtinDb !== undefined ? { builtinDb: Boolean(results.builtinDb) } : {}),
             ...(dbDialect ? { dbDialect } : {}),
+            ...(builtinDbImage || results.builtinDb === false ? { builtinDbImage: builtinDbImage || undefined } : {}),
             ...(dbHost ? { dbHost } : {}),
             ...(dbPort ? { dbPort } : {}),
             ...(dbDatabase ? { dbDatabase } : {}),
@@ -727,6 +750,10 @@ Prompt modes:
         if (dbDialect) {
             argv.push('--db-dialect', dbDialect);
         }
+        const builtinDbImage = String(results.builtinDbImage ?? '').trim();
+        if (builtinDb && builtinDbImage) {
+            argv.push('--builtin-db-image', builtinDbImage);
+        }
         const dbHost = String(results.dbHost ?? '').trim();
         if (dbHost) {
             argv.push('--db-host', dbHost);