@fluojs/cli 1.1.0 → 3.0.0

package/dist/new/scaffold.js

@@ -3,6 +3,8 @@ import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { initializeGitRepository, installDependencies } from './install.js';
 import { resolvePackageSpecs } from './package-spec-resolver.js';
+import { PUBLISHED_INTERNAL_DEPENDENCIES } from './published-internal-dependencies.js';
+import { createReactViteSsrScaffoldFiles } from './react-vite-ssr-scaffold.js';
 import { resolveBootstrapPlan } from './resolver.js';
 const PUBLISHED_DEV_DEPENDENCIES = {
   '@babel/cli': '^7.26.4',
@@ -11,39 +13,29 @@ const PUBLISHED_DEV_DEPENDENCIES = {
   '@babel/preset-typescript': '^7.27.1',
   '@types/babel__core': '^7.20.5',
   '@types/node': '^22.13.10',
-  '@vitest/coverage-v8': '^3.0.8',
-  tsx: '^4.20.4',
+  '@vitest/coverage-v8': '^4.1.11',
+  tsx: '^4.23.1',
   typescript: '^6.0.2',
-  vite: '^6.2.1',
-  vitest: '^3.0.8'
+  vite: '^8.2.2',
+  vitest: '^4.1.11'
 };
 const PUBLISHED_RUNTIME_DEPENDENCIES = {
+  '@playwright/test': '^1.51.1',
+  '@types/react': '^19.2.14',
+  '@types/react-dom': '^19.2.3',
   '@types/amqplib': '^0.10.7',
-  '@grpc/grpc-js': '^1.0.0',
+  '@grpc/grpc-js': '^1.14.4',
   '@grpc/proto-loader': '^0.8.0',
   amqplib: '^0.10.5',
   ioredis: '^5.0.0',
   kafkajs: '^2.2.4',
   mqtt: '^5.0.0',
-  nats: '^2.29.3'
-};
-const PUBLISHED_INTERNAL_DEPENDENCIES = {
-  '@fluojs/config': '^1.0.0',
-  '@fluojs/core': '^1.0.0',
-  '@fluojs/di': '^1.0.0',
-  '@fluojs/http': '^1.0.0',
-  '@fluojs/microservices': '^1.0.0',
-  '@fluojs/platform-bun': '^1.0.0',
-  '@fluojs/platform-cloudflare-workers': '^1.0.0',
-  '@fluojs/platform-deno': '^1.0.0',
-  '@fluojs/platform-express': '^1.0.0',
-  '@fluojs/platform-fastify': '^1.0.0',
-  '@fluojs/platform-nodejs': '^1.0.0',
-  '@fluojs/runtime': '^1.0.0',
-  '@fluojs/testing': '^1.0.0',
-  '@fluojs/validation': '^1.0.0',
-  '@fluojs/vite': '^1.0.0'
+  nats: '^2.29.3',
+  'happy-dom': '^20.9.0',
+  react: '^19.2.6',
+  'react-dom': '^19.2.6'
 };
+const NODE_HTTP_LISTENER_ENGINE = '>=24.0.0 <27';
 function describeApplicationStarter(options) {
   if (options.runtime === 'bun') {
     return {
@@ -153,6 +145,16 @@ function createExecCommand(packageManager, command) {
 }
 function createProjectScripts(bootstrapPlan) {
   switch (bootstrapPlan.profile.id) {
+    case 'application-node-fastify-react-vite-ssr':
+      return {
+        build: 'vite build --config vite.client.config.ts && vite build --config vite.server.config.ts',
+        dev: 'vite build --config vite.client.config.ts && vite build --config vite.server.config.ts && node dist/server/main.js',
+        start: 'node dist/server/main.js',
+        test: 'vitest run',
+        'test:browser': 'playwright test --config playwright.config.ts',
+        'test:watch': 'vitest',
+        typecheck: 'tsc -p tsconfig.json --noEmit'
+      };
     case 'application-bun-bun-http':
       return {
         build: 'bun build ./src/main.ts --outdir ./dist --target bun',
@@ -210,9 +212,17 @@ function createProjectEngines(bootstrapPlan) {
       return {
         deno: '>=2.0.0'
       };
+    case 'application-node-fastify-http':
+    case 'application-node-fastify-react-vite-ssr':
+    case 'application-node-express-http':
+    case 'application-node-nodejs-http':
+    case 'mixed-node-fastify-tcp':
+      return {
+        node: NODE_HTTP_LISTENER_ENGINE
+      };
     default:
       return {
-        node: '>=20.0.0'
+        node: NODE_HTTP_LISTENER_ENGINE
       };
   }
 }
@@ -233,7 +243,8 @@ function createPublishedDevDependencies(bootstrapPlan) {
     };
   }
   return {
-    ...PUBLISHED_DEV_DEPENDENCIES
+    ...PUBLISHED_DEV_DEPENDENCIES,
+    '@types/node': '^24.0.0'
   };
 }
 function createProjectPackageJson(options, bootstrapPlan, releaseVersion, packageSpecs) {
@@ -302,13 +313,12 @@ function createProjectTsconfigBuild() {
 }
 function createBabelConfig() {
   return `module.exports = {
-  ignore: ['src/**/*.test.ts'],
   presets: [['@babel/preset-typescript', { allowDeclareFields: true }]],
   plugins: [['@babel/plugin-proposal-decorators', { version: '2023-11' }]],
 };
 `;
 }
-function createViteConfig() {
+function createViteConfig(bootstrapPlan) {
   return `import { fluoDecoratorsPlugin } from '@fluojs/vite';
 import { defineConfig } from 'vite';
 
@@ -317,13 +327,13 @@ export default defineConfig({
   build: {
     emptyOutDir: true,
     outDir: 'dist',
-    rollupOptions: {
+    rolldownOptions: {
       output: {
         entryFileNames: 'main.js',
       },
     },
     ssr: 'src/main.ts',
-    target: 'node20',
+    target: '${bootstrapPlan.schema.runtime === 'node' ? 'node24' : 'node20'}',
   },
   server: {
     port: 5173,
@@ -1050,13 +1060,36 @@ const codec = JSONCodec();
 
 class LazyNatsTransport implements MicroserviceTransport {
   private connection: NatsConnection | undefined;
+  private initializing: Promise<NatsMicroserviceTransport> | undefined;
   private transport: NatsMicroserviceTransport | undefined;
 
   async close() {
-    await this.transport?.close();
-    await this.connection?.close();
-    this.transport = undefined;
-    this.connection = undefined;
+    const transport = this.initializing ? await this.initializing.catch(() => undefined) : this.transport;
+    let closeError: unknown;
+    let closeFailed = false;
+    try {
+      await transport?.close();
+    } catch (error) {
+      closeError = error;
+      closeFailed = true;
+    } finally {
+      try {
+        await this.connection?.close();
+      } catch (error) {
+        if (!closeFailed) {
+          closeError = error;
+          closeFailed = true;
+        }
+      } finally {
+        this.initializing = undefined;
+        this.transport = undefined;
+        this.connection = undefined;
+      }
+    }
+
+    if (closeFailed) {
+      throw closeError;
+    }
   }
 
   async emit(pattern: string, payload: unknown) {
@@ -1076,6 +1109,19 @@ class LazyNatsTransport implements MicroserviceTransport {
       return this.transport;
     }
 
+    this.initializing ??= this.createTransport();
+    try {
+      return await this.initializing;
+    } finally {
+      this.initializing = undefined;
+    }
+  }
+
+  private async createTransport() {
+    if (this.transport) {
+      return this.transport;
+    }
+
     const connection = await connect({
       name: 'fluo-microservice-starter',
       servers,
@@ -1149,18 +1195,24 @@ const responseTopic = process.env.KAFKA_RESPONSE_TOPIC ?? 'fluo.microservices.re
 
 class LazyKafkaTransport implements MicroserviceTransport {
   private consumer: Consumer | undefined;
+  private initializing: Promise<KafkaMicroserviceTransport> | undefined;
   private producer: Producer | undefined;
   private transport: KafkaMicroserviceTransport | undefined;
 
   async close() {
-    await this.transport?.close();
-    await Promise.all([
-      this.consumer?.disconnect().catch(() => undefined),
-      this.producer?.disconnect().catch(() => undefined),
-    ]);
-    this.consumer = undefined;
-    this.producer = undefined;
-    this.transport = undefined;
+    const transport = this.initializing ? await this.initializing.catch(() => undefined) : this.transport;
+    try {
+      await transport?.close();
+    } finally {
+      await Promise.all([
+        this.consumer?.disconnect().catch(() => undefined),
+        this.producer?.disconnect().catch(() => undefined),
+      ]);
+      this.initializing = undefined;
+      this.consumer = undefined;
+      this.producer = undefined;
+      this.transport = undefined;
+    }
   }
 
   async emit(pattern: string, payload: unknown) {
@@ -1180,6 +1232,19 @@ class LazyKafkaTransport implements MicroserviceTransport {
       return this.transport;
     }
 
+    this.initializing ??= this.createTransport();
+    try {
+      return await this.initializing;
+    } finally {
+      this.initializing = undefined;
+    }
+  }
+
+  private async createTransport() {
+    if (this.transport) {
+      return this.transport;
+    }
+
     const kafka = new Kafka({
       brokers,
       clientId,
@@ -1187,13 +1252,24 @@ class LazyKafkaTransport implements MicroserviceTransport {
     });
     const producer = kafka.producer();
     const consumer = kafka.consumer({ groupId: consumerGroup });
-    await Promise.all([producer.connect(), consumer.connect()]);
+    this.producer = producer;
+    this.consumer = consumer;
+    try {
+      await producer.connect();
+      await consumer.connect();
+    } catch (error) {
+      await Promise.all([
+        consumer.disconnect().catch(() => undefined),
+        producer.disconnect().catch(() => undefined),
+      ]);
+      this.consumer = undefined;
+      this.producer = undefined;
+      throw error;
+    }
 
     const handlers = new Map<string, (message: string) => Promise<void> | void>();
     let consumerRunning = false;
 
-    this.producer = producer;
-    this.consumer = consumer;
     this.transport = new KafkaMicroserviceTransport({
       consumer: {
         async subscribe(topic: string, handler: (message: string) => Promise<void> | void) {
@@ -1277,15 +1353,21 @@ const responseQueue = process.env.RABBITMQ_RESPONSE_QUEUE ?? 'fluo.microservices
 class LazyRabbitMqTransport implements MicroserviceTransport {
   private channel: Awaited<ReturnType<Awaited<ReturnType<typeof connect>>['createConfirmChannel']>> | undefined;
   private connection: Awaited<ReturnType<typeof connect>> | undefined;
+  private initializing: Promise<RabbitMqMicroserviceTransport> | undefined;
   private transport: RabbitMqMicroserviceTransport | undefined;
 
   async close() {
-    await this.transport?.close();
-    await this.channel?.close().catch(() => undefined);
-    await this.connection?.close().catch(() => undefined);
-    this.channel = undefined;
-    this.connection = undefined;
-    this.transport = undefined;
+    const transport = this.initializing ? await this.initializing.catch(() => undefined) : this.transport;
+    try {
+      await transport?.close();
+    } finally {
+      await this.channel?.close().catch(() => undefined);
+      await this.connection?.close().catch(() => undefined);
+      this.initializing = undefined;
+      this.channel = undefined;
+      this.connection = undefined;
+      this.transport = undefined;
+    }
   }
 
   async emit(pattern: string, payload: unknown) {
@@ -1305,11 +1387,31 @@ class LazyRabbitMqTransport implements MicroserviceTransport {
       return this.transport;
     }
 
+    this.initializing ??= this.createTransport();
+    try {
+      return await this.initializing;
+    } finally {
+      this.initializing = undefined;
+    }
+  }
+
+  private async createTransport() {
+    if (this.transport) {
+      return this.transport;
+    }
+
     const connection = await connect(url);
-    const channel = await connection.createConfirmChannel();
+    this.connection = connection;
+    let channel: Awaited<ReturnType<typeof connection.createConfirmChannel>>;
+    try {
+      channel = await connection.createConfirmChannel();
+    } catch (error) {
+      await connection.close().catch(() => undefined);
+      this.connection = undefined;
+      throw error;
+    }
     const consumerTags = new Map<string, string>();
 
-    this.connection = connection;
     this.channel = channel;
     this.transport = new RabbitMqMicroserviceTransport({
       consumer: {
@@ -1993,11 +2095,29 @@ function createWranglerConfig(projectName) {
 }
 function emitSharedScaffoldFiles(options, bootstrapPlan, releaseVersion, packageSpecs) {
   const envFile = createEnvFile(bootstrapPlan);
+  if (bootstrapPlan.profile.id === 'application-node-fastify-react-vite-ssr') {
+    return [{
+      content: createProjectPackageJson(options, bootstrapPlan, releaseVersion, packageSpecs),
+      path: 'package.json'
+    }, ...createReactViteSsrScaffoldFiles({
+      packageManager: options.packageManager,
+      projectName: options.projectName
+    }), {
+      content: createBabelConfig(),
+      path: 'babel.config.cjs'
+    }, {
+      content: createGitignore(),
+      path: '.gitignore'
+    }, ...(envFile ? [{
+      content: envFile,
+      path: '.env'
+    }] : [])];
+  }
   const sharedFiles = [{
     content: createProjectPackageJson(options, bootstrapPlan, releaseVersion, packageSpecs),
     path: 'package.json'
   }, {
-    content: createProjectReadme(options, bootstrapPlan),
+    content: createProjectReadme(options, bootstrapPlan) + (bootstrapPlan.schema.runtime === 'node' ? '\n## Node.js support\n\nRequires Node.js `>=24.0.0 <27`. Use Node 24 LTS for local development, CI, and container images. Node builds target `node24` and use `@types/node@^24.0.0`.\n' : ''),
     path: 'README.md'
   }, {
     content: createGitignore(),
@@ -2014,7 +2134,7 @@ function emitSharedScaffoldFiles(options, bootstrapPlan, releaseVersion, package
       content: createBabelConfig(),
       path: 'babel.config.cjs'
     }, {
-      content: createViteConfig(),
+      content: createViteConfig(bootstrapPlan),
       path: 'vite.config.ts'
     }, {
       content: createVitestConfig(),
@@ -2089,6 +2209,9 @@ function emitApplicationScaffoldFiles(options) {
   return files;
 }
 function emitScaffoldFilesForRecipe(options, recipeId) {
+  if (recipeId === 'application-node-fastify-react-vite-ssr') {
+    return [];
+  }
   if (recipeId === 'application-bun-bun-http' || recipeId === 'application-cloudflare-workers-cloudflare-workers-http' || recipeId === 'application-deno-deno-http' || recipeId === 'application-node-fastify-http' || recipeId === 'application-node-express-http' || recipeId === 'application-node-nodejs-http') {
     return emitApplicationScaffoldFiles(options);
   }

package/dist/new/starter-profiles.d.ts

@@ -1,8 +1,8 @@
-import type { BootstrapPlatform, BootstrapRuntime, BootstrapSchema, BootstrapShape, BootstrapToolingPreset, BootstrapTopology, BootstrapTransport } from './types.js';
+import type { BootstrapPlatform, BootstrapRuntime, BootstrapSchema, BootstrapShape, BootstrapStarter, BootstrapToolingPreset, BootstrapTopology, BootstrapTransport } from './types.js';
 /** Emitter families that decide which scaffold template tree renders the starter. */
-export type StarterEmitterType = 'http' | 'microservice' | 'mixed';
+export type StarterEmitterType = 'http' | 'microservice' | 'mixed' | 'react-vite-ssr';
 /** Stable IDs for the scaffold recipes currently shipped by `fluo new`. */
-export type StarterScaffoldRecipeId = 'application-bun-bun-http' | 'application-cloudflare-workers-cloudflare-workers-http' | 'application-deno-deno-http' | 'application-node-express-http' | 'application-node-fastify-http' | 'application-node-nodejs-http' | 'microservice-node-none-grpc' | 'microservice-node-none-kafka' | 'microservice-node-none-mqtt' | 'microservice-node-none-nats' | 'microservice-node-none-rabbitmq' | 'microservice-node-none-redis-streams' | 'microservice-node-none-tcp' | 'mixed-node-fastify-tcp';
+export type StarterScaffoldRecipeId = 'application-bun-bun-http' | 'application-cloudflare-workers-cloudflare-workers-http' | 'application-deno-deno-http' | 'application-node-express-http' | 'application-node-fastify-http' | 'application-node-fastify-react-vite-ssr' | 'application-node-nodejs-http' | 'microservice-node-none-grpc' | 'microservice-node-none-kafka' | 'microservice-node-none-mqtt' | 'microservice-node-none-nats' | 'microservice-node-none-rabbitmq' | 'microservice-node-none-redis-streams' | 'microservice-node-none-tcp' | 'mixed-node-fastify-tcp';
 type StarterDependencies = {
     dependencies: readonly string[];
     devDependencies: readonly string[];
@@ -21,6 +21,7 @@ export interface StarterProfile {
     platformPromptLabel?: string;
     promptLabel: string;
     schema: BootstrapSchema;
+    starter: BootstrapStarter;
 }
 /** Supported microservice starter transports recognized by `fluo new`. */
 export declare const SUPPORTED_MICROSERVICE_STARTER_TRANSPORTS: readonly BootstrapTransport[];
@@ -40,6 +41,8 @@ export declare const SUPPORTED_BOOTSTRAP_TRANSPORTS: readonly BootstrapTransport
 export declare const SUPPORTED_BOOTSTRAP_TOOLING_PRESETS: readonly BootstrapToolingPreset[];
 /** Supported topology modes accepted by the current starter matrix. */
 export declare const SUPPORTED_BOOTSTRAP_TOPOLOGY_MODES: readonly BootstrapTopology['mode'][];
+/** Named starter variants accepted by `fluo new`. */
+export declare const SUPPORTED_BOOTSTRAP_STARTERS: readonly BootstrapStarter[];
 /** Default starter profile used for shape-less `fluo new` invocations. */
 export declare const DEFAULT_BOOTSTRAP_PROFILE: StarterProfile;
 /**
@@ -75,9 +78,10 @@ export declare function getDefaultBootstrapSchema(): BootstrapSchema;
  * Finds the starter profile that exactly matches a resolved bootstrap schema.
  *
  * @param schema Fully resolved bootstrap schema.
+ * @param starter Named starter variant selected by the caller.
  * @returns The matching starter profile, or `undefined` when the schema is validation-only.
  */
-export declare function getStarterProfileFromSchema(schema: BootstrapSchema): StarterProfile | undefined;
+export declare function getStarterProfileFromSchema(schema: BootstrapSchema, starter?: BootstrapStarter): StarterProfile | undefined;
 /**
  * Checks whether one transport belongs to the supported microservice starter transport family.
  *

package/dist/new/starter-profiles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"starter-profiles.d.ts","sourceRoot":"","sources":["../../src/new/starter-profiles.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"starter-profiles.d.ts","sourceRoot":"","sources":["../../src/new/starter-profiles.ts"],"names":[],"mappings":"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"}

package/dist/new/starter-profiles.js

@@ -51,7 +51,8 @@ export const STARTER_PROFILE_REGISTRY = [{
   id: 'application-bun-bun-http',
   platformPromptLabel: 'Bun native HTTP',
   promptLabel: 'Application (HTTP starter)',
-  schema: createSchema('application', 'bun', 'bun', 'http')
+  schema: createSchema('application', 'bun', 'bun', 'http'),
+  starter: 'standard'
 }, {
   dependencies: {
     dependencies: ['@fluojs/config', '@fluojs/core', '@fluojs/validation', '@fluojs/di', '@fluojs/http', '@fluojs/platform-deno', '@fluojs/runtime'],
@@ -67,7 +68,8 @@ export const STARTER_PROFILE_REGISTRY = [{
   id: 'application-deno-deno-http',
   platformPromptLabel: 'Deno native HTTP',
   promptLabel: 'Application (HTTP starter)',
-  schema: createSchema('application', 'deno', 'deno', 'http')
+  schema: createSchema('application', 'deno', 'deno', 'http'),
+  starter: 'standard'
 }, {
   dependencies: {
     dependencies: ['@fluojs/core', '@fluojs/validation', '@fluojs/di', '@fluojs/http', '@fluojs/platform-cloudflare-workers', '@fluojs/runtime'],
@@ -83,7 +85,8 @@ export const STARTER_PROFILE_REGISTRY = [{
   id: 'application-cloudflare-workers-cloudflare-workers-http',
   platformPromptLabel: 'Cloudflare Workers',
   promptLabel: 'Application (HTTP starter)',
-  schema: createSchema('application', 'cloudflare-workers', 'cloudflare-workers', 'http')
+  schema: createSchema('application', 'cloudflare-workers', 'cloudflare-workers', 'http'),
+  starter: 'standard'
 }, {
   dependencies: {
     dependencies: ['@fluojs/config', '@fluojs/core', '@fluojs/validation', '@fluojs/di', '@fluojs/http', '@fluojs/platform-fastify', '@fluojs/runtime'],
@@ -99,7 +102,25 @@ export const STARTER_PROFILE_REGISTRY = [{
   id: 'application-node-fastify-http',
   platformPromptLabel: 'Fastify',
   promptLabel: 'Application (HTTP starter)',
-  schema: createSchema('application', 'node', 'fastify', 'http')
+  schema: createSchema('application', 'node', 'fastify', 'http'),
+  starter: 'standard'
+}, {
+  dependencies: {
+    dependencies: ['@fluojs/core', '@fluojs/http', '@fluojs/platform-fastify', '@fluojs/react', '@fluojs/runtime', '@fluojs/validation', 'react', 'react-dom'],
+    devDependencies: ['@fluojs/cli', '@fluojs/testing', '@fluojs/vite', '@playwright/test', '@types/react', '@types/react-dom', 'happy-dom']
+  },
+  emitter: {
+    platform: 'fastify',
+    preset: 'standard',
+    runtime: 'node',
+    transport: 'http',
+    type: 'react-vite-ssr'
+  },
+  id: 'application-node-fastify-react-vite-ssr',
+  platformPromptLabel: 'Fastify',
+  promptLabel: 'React SSR + Vite',
+  schema: createSchema('application', 'node', 'fastify', 'http'),
+  starter: 'react-vite-ssr'
 }, {
   dependencies: {
     dependencies: ['@fluojs/config', '@fluojs/core', '@fluojs/validation', '@fluojs/di', '@fluojs/http', '@fluojs/platform-express', '@fluojs/runtime'],
@@ -115,7 +136,8 @@ export const STARTER_PROFILE_REGISTRY = [{
   id: 'application-node-express-http',
   platformPromptLabel: 'Express',
   promptLabel: 'Application (HTTP starter)',
-  schema: createSchema('application', 'node', 'express', 'http')
+  schema: createSchema('application', 'node', 'express', 'http'),
+  starter: 'standard'
 }, {
   dependencies: {
     dependencies: ['@fluojs/config', '@fluojs/core', '@fluojs/validation', '@fluojs/di', '@fluojs/http', '@fluojs/platform-nodejs', '@fluojs/runtime'],
@@ -131,7 +153,8 @@ export const STARTER_PROFILE_REGISTRY = [{
   id: 'application-node-nodejs-http',
   platformPromptLabel: 'Raw Node.js HTTP',
   promptLabel: 'Application (HTTP starter)',
-  schema: createSchema('application', 'node', 'nodejs', 'http')
+  schema: createSchema('application', 'node', 'nodejs', 'http'),
+  starter: 'standard'
 }, {
   dependencies: {
     dependencies: ['@fluojs/config', '@fluojs/core', '@fluojs/di', '@fluojs/microservices', '@fluojs/runtime'],
@@ -146,7 +169,8 @@ export const STARTER_PROFILE_REGISTRY = [{
   },
   id: 'microservice-node-none-tcp',
   promptLabel: 'Microservice (transport-first starter)',
-  schema: createSchema('microservice', 'node', 'none', 'tcp')
+  schema: createSchema('microservice', 'node', 'none', 'tcp'),
+  starter: 'standard'
 }, {
   dependencies: {
     dependencies: ['@fluojs/config', '@fluojs/core', '@fluojs/di', '@fluojs/microservices', '@fluojs/runtime', 'ioredis'],
@@ -161,7 +185,8 @@ export const STARTER_PROFILE_REGISTRY = [{
   },
   id: 'microservice-node-none-redis-streams',
   promptLabel: 'Microservice (Redis Streams starter)',
-  schema: createSchema('microservice', 'node', 'none', 'redis-streams')
+  schema: createSchema('microservice', 'node', 'none', 'redis-streams'),
+  starter: 'standard'
 }, {
   dependencies: {
     dependencies: ['@fluojs/config', '@fluojs/core', '@fluojs/di', '@fluojs/microservices', '@fluojs/runtime', 'mqtt'],
@@ -176,7 +201,8 @@ export const STARTER_PROFILE_REGISTRY = [{
   },
   id: 'microservice-node-none-mqtt',
   promptLabel: 'Microservice (MQTT starter)',
-  schema: createSchema('microservice', 'node', 'none', 'mqtt')
+  schema: createSchema('microservice', 'node', 'none', 'mqtt'),
+  starter: 'standard'
 }, {
   dependencies: {
     dependencies: ['@fluojs/config', '@fluojs/core', '@fluojs/di', '@fluojs/microservices', '@fluojs/runtime', '@grpc/grpc-js', '@grpc/proto-loader'],
@@ -191,7 +217,8 @@ export const STARTER_PROFILE_REGISTRY = [{
   },
   id: 'microservice-node-none-grpc',
   promptLabel: 'Microservice (gRPC starter)',
-  schema: createSchema('microservice', 'node', 'none', 'grpc')
+  schema: createSchema('microservice', 'node', 'none', 'grpc'),
+  starter: 'standard'
 }, {
   dependencies: {
     dependencies: ['@fluojs/config', '@fluojs/core', '@fluojs/di', '@fluojs/microservices', '@fluojs/runtime', 'nats'],
@@ -206,7 +233,8 @@ export const STARTER_PROFILE_REGISTRY = [{
   },
   id: 'microservice-node-none-nats',
   promptLabel: 'Microservice (NATS starter)',
-  schema: createSchema('microservice', 'node', 'none', 'nats')
+  schema: createSchema('microservice', 'node', 'none', 'nats'),
+  starter: 'standard'
 }, {
   dependencies: {
     dependencies: ['@fluojs/config', '@fluojs/core', '@fluojs/di', '@fluojs/microservices', '@fluojs/runtime', 'kafkajs'],
@@ -221,7 +249,8 @@ export const STARTER_PROFILE_REGISTRY = [{
   },
   id: 'microservice-node-none-kafka',
   promptLabel: 'Microservice (Kafka starter)',
-  schema: createSchema('microservice', 'node', 'none', 'kafka')
+  schema: createSchema('microservice', 'node', 'none', 'kafka'),
+  starter: 'standard'
 }, {
   dependencies: {
     dependencies: ['@fluojs/config', '@fluojs/core', '@fluojs/di', '@fluojs/microservices', '@fluojs/runtime', 'amqplib'],
@@ -236,7 +265,8 @@ export const STARTER_PROFILE_REGISTRY = [{
   },
   id: 'microservice-node-none-rabbitmq',
   promptLabel: 'Microservice (RabbitMQ starter)',
-  schema: createSchema('microservice', 'node', 'none', 'rabbitmq')
+  schema: createSchema('microservice', 'node', 'none', 'rabbitmq'),
+  starter: 'standard'
 }, {
   dependencies: {
     dependencies: ['@fluojs/config', '@fluojs/core', '@fluojs/validation', '@fluojs/di', '@fluojs/http', '@fluojs/microservices', '@fluojs/platform-fastify', '@fluojs/runtime'],
@@ -251,7 +281,8 @@ export const STARTER_PROFILE_REGISTRY = [{
   },
   id: 'mixed-node-fastify-tcp',
   promptLabel: 'Mixed (HTTP API + microservice starter)',
-  schema: createSchema('mixed', 'node', 'fastify', 'tcp')
+  schema: createSchema('mixed', 'node', 'fastify', 'tcp'),
+  starter: 'standard'
 }];
 
 /** Supported scaffold shapes accepted by the current starter matrix. */
@@ -266,6 +297,8 @@ export const SUPPORTED_BOOTSTRAP_TRANSPORTS = ['http', ...SUPPORTED_MICROSERVICE
 export const SUPPORTED_BOOTSTRAP_TOOLING_PRESETS = ['standard'];
 /** Supported topology modes accepted by the current starter matrix. */
 export const SUPPORTED_BOOTSTRAP_TOPOLOGY_MODES = ['single-package'];
+/** Named starter variants accepted by `fluo new`. */
+export const SUPPORTED_BOOTSTRAP_STARTERS = ['standard', 'react-vite-ssr'];
 
 /** Default starter profile used for shape-less `fluo new` invocations. */
 export const DEFAULT_BOOTSTRAP_PROFILE = STARTER_PROFILE_REGISTRY.find(profile => profile.id === 'application-node-fastify-http');
@@ -279,7 +312,7 @@ export const DEFAULT_BOOTSTRAP_PROFILE = STARTER_PROFILE_REGISTRY.find(profile =
  */
 export function getStarterProfileForShape(shape, runtime) {
   if (runtime !== undefined) {
-    return STARTER_PROFILE_REGISTRY.find(profile => profile.schema.shape === shape && profile.schema.runtime === runtime) ?? DEFAULT_BOOTSTRAP_PROFILE;
+    return STARTER_PROFILE_REGISTRY.find(profile => profile.starter === 'standard' && profile.schema.shape === shape && profile.schema.runtime === runtime) ?? DEFAULT_BOOTSTRAP_PROFILE;
   }
   if (shape === 'application') {
     return DEFAULT_BOOTSTRAP_PROFILE;
@@ -300,7 +333,7 @@ export function getStarterProfileForShape(shape, runtime) {
  * @returns Application starter profiles for the selected runtime, or all application starters when omitted.
  */
 export function getApplicationStarterProfiles(runtime) {
-  return STARTER_PROFILE_REGISTRY.filter(profile => profile.schema.shape === 'application' && (runtime === undefined || profile.schema.runtime === runtime));
+  return STARTER_PROFILE_REGISTRY.filter(profile => profile.starter === 'standard' && profile.schema.shape === 'application' && (runtime === undefined || profile.schema.runtime === runtime));
 }
 
 /**
@@ -327,10 +360,11 @@ export function getDefaultBootstrapSchema() {
  * Finds the starter profile that exactly matches a resolved bootstrap schema.
  *
  * @param schema Fully resolved bootstrap schema.
+ * @param starter Named starter variant selected by the caller.
  * @returns The matching starter profile, or `undefined` when the schema is validation-only.
  */
-export function getStarterProfileFromSchema(schema) {
-  return STARTER_PROFILE_REGISTRY.find(profile => profile.schema.shape === schema.shape && profile.schema.runtime === schema.runtime && profile.schema.platform === schema.platform && profile.schema.transport === schema.transport && profile.schema.tooling === schema.tooling && profile.schema.topology.deferred === schema.topology.deferred && profile.schema.topology.mode === schema.topology.mode);
+export function getStarterProfileFromSchema(schema, starter = 'standard') {
+  return STARTER_PROFILE_REGISTRY.find(profile => profile.starter === starter && profile.schema.shape === schema.shape && profile.schema.runtime === schema.runtime && profile.schema.platform === schema.platform && profile.schema.transport === schema.transport && profile.schema.tooling === schema.tooling && profile.schema.topology.deferred === schema.topology.deferred && profile.schema.topology.mode === schema.topology.mode);
 }
 
 /**