CLI: Add optional --dev and --no-dev options to storybook init CLI

code/lib/cli/src/generate.ts

@@ -58,6 +58,17 @@ command('init')
  .option('-y --yes', 'Answer yes to all prompts')
  .option('-b --builder <webpack5 | vite>', 'Builder library')
  .option('-l --linkable', 'Prepare installation for link (contributor helper)')
+ // due to how Commander handles default values and negated options, we have to elevate the default into Commander, and we have to specify `--dev`
+ // alongside `--no-dev` even if we are unlikely to directly use `--dev`. https://github.com/tj/commander.js/issues/2068#issuecomment-1804524585
+ .option(
+ '--dev',
+ 'Launch the development server after completing initialization. Enabled by default',
+ process.env.CI !== 'true' && process.env.IN_STORYBOOK_SANDBOX !== 'true'
+ )
+ .option(
+ '--no-dev',
+ 'Complete the initialization of Storybook without launching the Storybook development server'
+ )
  .action((options: CommandOptions) => {
  initiate(options).catch(() => process.exit(1));
  });

code/lib/cli/src/generators/types.ts

@@ -53,4 +53,5 @@ export type CommandOptions = {
  disableTelemetry?: boolean;
  enableCrashReports?: boolean;
  debug?: boolean;
+ dev?: boolean;
 };

code/lib/cli/src/initiate.ts

@@ -405,7 +405,7 @@ export async function doInitiate(options: CommandOptions): Promise<
  );
 
  return {
- shouldRunDev: process.env.CI !== 'true' && process.env.IN_STORYBOOK_SANDBOX !== 'true',
+ shouldRunDev: !!options.dev,
  projectType,
  packageManager,
  storybookCommand,

code/lib/cli/src/sandbox.ts

@@ -225,6 +225,7 @@ export const sandbox = async ({
  process.chdir(templateDestination);
  // we run doInitiate, instead of initiate, to avoid sending this init event to telemetry, because it's not a real world project
  await doInitiate({
+ dev: process.env.CI !== 'true' && process.env.IN_STORYBOOK_SANBOX !== 'true',
  ...options,
  });
  process.chdir(before);

docs/api/cli-options.md

@@ -119,6 +119,7 @@ Options include:
 | `--debug` | Outputs more logs in the CLI to assist debugging<br/>`storybook init --debug` |
 | `--disable-telemetry` | Disables Storybook's telemetry. Learn more about it [here](../configure/telemetry.md#how-to-opt-out)<br/>`storybook init --disable-telemetry` |
 | `--enable-crash-reports` | Enables sending crash reports to Storybook's telemetry. Learn more about it [here](../configure/telemetry.md#crash-reports-disabled-by-default)<br/>`storybook init --enable-crash-reports` |
+| `--no-dev` | Complete the initialization of Storybook without running the Storybook dev server<br/>`storybook init --no-dev` |
 
 ### `add`