@fluixi/start 0.1.0-alpha.74 → 0.1.0-alpha.76

package/dist/commands/build.mjs

@@ -20,6 +20,8 @@ function resolveConfig(config = {}) {
     middleware: config.middleware ?? "src/middleware.ts",
     ssrNoExternal: config.ssrNoExternal ?? [],
     resolve: config.resolve ?? [],
+    vitePlugin: config.vitePlugin ?? {},
+    plugins: config.plugins ?? [],
     adapter: config.adapter,
     i18n: resolveI18n(config.i18n),
     prerender: resolvePrerender(config.prerender)
@@ -215,7 +217,7 @@ function startTypesPlugin(cfg) {
       const blocks = [];
       if (cfg.i18n) blocks.push(...i18nTypeBlock(root, cfg.i18n));
       if (blocks.length === 0) return;
-      const content = `// Auto-generated by @fluixi/start — do not edit.
+      const content = `// Auto-generated by @fluixi/start, do not edit.
 ${blocks.join("\n")}
 `;
       const file = resolvePath(root, "src/fluixi-start-env.d.ts");
@@ -236,12 +238,17 @@ async function fluixiPlugins(cfg) {
     // app has no way to say where an unimported tag comes from.
     //
     // `fluixi()` and not `createVitePlugin()`: the latter is the bare compiler integration,
-    // and the reactive graph — agent, source marks, /__fluixi/graph — is composed on top of
+    // and the reactive graph: agent, source marks, /__fluixi/graph, is composed on top of
     // it by the former. A start app got no graph at all until this changed.
-    fluixi({ resolve: cfg.resolve })
+    // Everything the app declared for the compiler, with `resolve` still usable on its
+    // own because it is the one most apps set. A start app never writes
+    // `fluixi()` itself, so without this passthrough the plugin's other options
+    // (propsDestructure and the rest) had nowhere to be declared.
+    fluixi({ ...cfg.vitePlugin ?? {}, ...cfg.resolve ? { resolve: cfg.resolve } : {} })
   ];
+  if (cfg.plugins?.length) plugins.push(...cfg.plugins);
   if (cfg.i18n) plugins.push(i18nVitePlugin(cfg.i18n));
-  const { apiRoutesVitePlugin } = await import("./api-RH6E5UTH.mjs");
+  const { apiRoutesVitePlugin } = await import("./api-HD7KU3BS.mjs");
   plugins.push(apiRoutesVitePlugin({ dir: cfg.apiDir }));
   plugins.push(startTypesPlugin(cfg));
   return plugins;
@@ -401,14 +408,14 @@ async function loadPreloader(cfg) {
 }
 var GENERATED_SUBPATHS = /* @__PURE__ */ new Set(["./routes", "./server-fns", "./api-routes"]);
 function ssrBuildOptions(cfg) {
-  const noExternal = cfg.ssrNoExternal.length ? cfg.ssrNoExternal : void 0;
+  const noExternal = [.../* @__PURE__ */ new Set(["@fluixi/core", ...cfg.ssrNoExternal])];
   const mode = cfg.adapter?.bundle;
   if (mode === "inline") return { noExternal: true };
   if (mode !== "external") return { noExternal };
   const external = frameworkDeps(cfg.root).filter((name) => !cfg.ssrNoExternal.includes(name)).flatMap((name) => withSubpaths(cfg.root, name));
   if (!external.length) {
     console.warn(
-      `  fluixi: adapter "${cfg.adapter?.name}" builds an externalized server, but no fluixi or @fluixi/* dependency was found in ${join(cfg.root, "package.json")} — bundling everything.`
+      `  fluixi: adapter "${cfg.adapter?.name}" builds an externalized server, but no fluixi or @fluixi/* dependency was found in ${join(cfg.root, "package.json")}, bundling everything.`
     );
   }
   return { noExternal, external: external.length ? external : void 0 };
@@ -689,7 +696,7 @@ async function bundleEntry(cfg, plugins, source, outFile) {
           output: {
             entryFileNames: basename(outFile),
             // One file, no chunks. A lazy route would otherwise be split out beside
-            // the entry — and for Cloudflare that directory is the published one, so
+            // the entry: and for Cloudflare that directory is the published one, so
             // every server chunk would be a public download.
             inlineDynamicImports: true
           }

package/dist/commands/{chunk-OCPCK4ZJ.mjs → chunk-JACRXSN7.mjs}

@@ -1,4 +1,4 @@
-/*! @fluixi/start v0.1.0-alpha.74 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/start v0.1.0-alpha.76 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 
 // src/api.ts
 import { readdirSync, statSync } from "node:fs";
@@ -75,7 +75,7 @@ function apiRoutesVitePlugin(opts) {
   return {
     name: "fluixi-api",
     // Must beat node resolution: '@fluixi/start/api-routes' is a real file in this package,
-    // so without `pre` Vite resolves the typed stub and the generated table never loads —
+    // so without `pre` Vite resolves the typed stub and the generated table never loads , 
     // the app builds and every API route 404s.
     enforce: "pre",
     configResolved(config) {

package/dist/commands/{chunk-NS5GR2GX.mjs → chunk-MTM6M3TC.mjs}

@@ -73,7 +73,7 @@ function apiRoutesVitePlugin(opts) {
   return {
     name: "fluixi-api",
     // Must beat node resolution: '@fluixi/start/api-routes' is a real file in this package,
-    // so without `pre` Vite resolves the typed stub and the generated table never loads —
+    // so without `pre` Vite resolves the typed stub and the generated table never loads , 
     // the app builds and every API route 404s.
     enforce: "pre",
     configResolved(config) {

package/dist/commands/dev.cjs

@@ -110,7 +110,7 @@ function apiRoutesVitePlugin(opts) {
   return {
     name: "fluixi-api",
     // Must beat node resolution: '@fluixi/start/api-routes' is a real file in this package,
-    // so without `pre` Vite resolves the typed stub and the generated table never loads —
+    // so without `pre` Vite resolves the typed stub and the generated table never loads , 
     // the app builds and every API route 404s.
     enforce: "pre",
     configResolved(config) {
@@ -179,6 +179,8 @@ function resolveConfig(config = {}) {
     middleware: config.middleware ?? "src/middleware.ts",
     ssrNoExternal: config.ssrNoExternal ?? [],
     resolve: config.resolve ?? [],
+    vitePlugin: config.vitePlugin ?? {},
+    plugins: config.plugins ?? [],
     adapter: config.adapter,
     i18n: resolveI18n(config.i18n),
     prerender: resolvePrerender(config.prerender)
@@ -363,7 +365,7 @@ function startTypesPlugin(cfg) {
       const blocks = [];
       if (cfg.i18n) blocks.push(...i18nTypeBlock(root, cfg.i18n));
       if (blocks.length === 0) return;
-      const content = `// Auto-generated by @fluixi/start — do not edit.
+      const content = `// Auto-generated by @fluixi/start, do not edit.
 ${blocks.join("\n")}
 `;
       const file = (0, import_node_path3.resolve)(root, "src/fluixi-start-env.d.ts");
@@ -384,10 +386,15 @@ async function fluixiPlugins(cfg) {
     // app has no way to say where an unimported tag comes from.
     //
     // `fluixi()` and not `createVitePlugin()`: the latter is the bare compiler integration,
-    // and the reactive graph — agent, source marks, /__fluixi/graph — is composed on top of
+    // and the reactive graph: agent, source marks, /__fluixi/graph, is composed on top of
     // it by the former. A start app got no graph at all until this changed.
-    fluixi({ resolve: cfg.resolve })
+    // Everything the app declared for the compiler, with `resolve` still usable on its
+    // own because it is the one most apps set. A start app never writes
+    // `fluixi()` itself, so without this passthrough the plugin's other options
+    // (propsDestructure and the rest) had nowhere to be declared.
+    fluixi({ ...cfg.vitePlugin ?? {}, ...cfg.resolve ? { resolve: cfg.resolve } : {} })
   ];
+  if (cfg.plugins?.length) plugins.push(...cfg.plugins);
   if (cfg.i18n) plugins.push(i18nVitePlugin(cfg.i18n));
   const { apiRoutesVitePlugin: apiRoutesVitePlugin2 } = await Promise.resolve().then(() => (init_api(), api_exports));
   plugins.push(apiRoutesVitePlugin2({ dir: cfg.apiDir }));
@@ -653,7 +660,12 @@ async function dev(config = {}) {
     // file routing + JSX/SSR transform (fluixi)
     server: { middlewareMode: true, hmr: { server: http } },
     appType: "custom",
-    ssr: cfg.ssrNoExternal.length ? { noExternal: cfg.ssrNoExternal } : void 0
+    // `@fluixi/core` always goes through vite rather than being externalized.
+    // `@fluixi/core/routes` is served by fluixiRoutesPlugin, and an externalized
+    // dependency is imported by node directly, so no plugin ever sees the specifier and
+    // the app gets the "did not replace it" stub instead of its route tree. A workspace
+    // app hides this by resolving the package to source.
+    ssr: { noExternal: ["@fluixi/core", ...cfg.ssrNoExternal] }
   });
   http.listen(cfg.port, () => devReady({ port: cfg.port, startedAt }));
 }

package/dist/commands/dev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAkDjD;;;;GAIG;AACH,wBAAsB,GAAG,CAAC,MAAM,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsFlE"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAkDjD;;;;GAIG;AACH,wBAAsB,GAAG,CAAC,MAAM,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2FlE"}

package/dist/commands/dev.js

@@ -12,7 +12,7 @@ const STYLE_FILE = /\.(css|scss|sass|less|styl|stylus|pcss|postcss)(\?|$)/;
  * Stylesheets the SSR render pulled in, walked from the server entry.
  *
  * Without these, dev serves a fully rendered page with no CSS at all and the styles
- * arrive with the client bundle — a flash of unstyled content on every load, in the one
+ * arrive with the client bundle: a flash of unstyled content on every load, in the one
  * environment you look at most. The build has no such gap: Vite emits real `<link>`s.
  *
  * Dev serves a `.css` URL as a JS module that injects a style tag, so `?direct` is what
@@ -75,13 +75,13 @@ export async function dev(config = {}) {
         const path = url.pathname + url.search;
         // Server-function RPC: auto-wired. Load the registry vmod (registers every "use server"
         // fn + wires the request-context runner + re-exports the dispatcher) and route /_server
-        // through it — no need for the app's entry-server to re-export anything.
+        // through it: no need for the app's entry-server to re-export anything.
         if (url.pathname === '/_server') {
             const sf = await vite.ssrLoadModule(SERVER_FNS_VMOD);
             if (sf.isServerFnRequest(request))
                 return sf.handleServerFn(request);
         }
-        // File-based API routes (src/api/** → /api/*) — auto-wired, no entry change needed.
+        // File-based API routes (src/api/** → /api/*), auto-wired, no entry change needed.
         if (isApiPath(url.pathname)) {
             const api = await vite.ssrLoadModule(API_VIRTUAL_MODULE);
             if (api.isApiRequest(request))
@@ -128,7 +128,12 @@ export async function dev(config = {}) {
         plugins: await fluixiPlugins(cfg), // file routing + JSX/SSR transform (fluixi)
         server: { middlewareMode: true, hmr: { server: http } },
         appType: 'custom',
-        ssr: cfg.ssrNoExternal.length ? { noExternal: cfg.ssrNoExternal } : undefined,
+        // `@fluixi/core` always goes through vite rather than being externalized.
+        // `@fluixi/core/routes` is served by fluixiRoutesPlugin, and an externalized
+        // dependency is imported by node directly, so no plugin ever sees the specifier and
+        // the app gets the "did not replace it" stub instead of its route tree. A workspace
+        // app hides this by resolving the package to source.
+        ssr: { noExternal: ['@fluixi/core', ...cfg.ssrNoExternal] },
     });
     http.listen(cfg.port, () => devReady({ port: cfg.port, startedAt }));
 }

package/dist/commands/dev.mjs

@@ -1,7 +1,7 @@
 import {
   API_VIRTUAL_MODULE,
   isApiPath
-} from "./chunk-NS5GR2GX.mjs";
+} from "./chunk-MTM6M3TC.mjs";
 
 // src/commands/dev.ts
 import { createServer as createHttp } from "node:http";
@@ -25,6 +25,8 @@ function resolveConfig(config = {}) {
     middleware: config.middleware ?? "src/middleware.ts",
     ssrNoExternal: config.ssrNoExternal ?? [],
     resolve: config.resolve ?? [],
+    vitePlugin: config.vitePlugin ?? {},
+    plugins: config.plugins ?? [],
     adapter: config.adapter,
     i18n: resolveI18n(config.i18n),
     prerender: resolvePrerender(config.prerender)
@@ -209,7 +211,7 @@ function startTypesPlugin(cfg) {
       const blocks = [];
       if (cfg.i18n) blocks.push(...i18nTypeBlock(root, cfg.i18n));
       if (blocks.length === 0) return;
-      const content = `// Auto-generated by @fluixi/start — do not edit.
+      const content = `// Auto-generated by @fluixi/start, do not edit.
 ${blocks.join("\n")}
 `;
       const file = resolvePath(root, "src/fluixi-start-env.d.ts");
@@ -230,12 +232,17 @@ async function fluixiPlugins(cfg) {
     // app has no way to say where an unimported tag comes from.
     //
     // `fluixi()` and not `createVitePlugin()`: the latter is the bare compiler integration,
-    // and the reactive graph — agent, source marks, /__fluixi/graph — is composed on top of
+    // and the reactive graph: agent, source marks, /__fluixi/graph, is composed on top of
     // it by the former. A start app got no graph at all until this changed.
-    fluixi({ resolve: cfg.resolve })
+    // Everything the app declared for the compiler, with `resolve` still usable on its
+    // own because it is the one most apps set. A start app never writes
+    // `fluixi()` itself, so without this passthrough the plugin's other options
+    // (propsDestructure and the rest) had nowhere to be declared.
+    fluixi({ ...cfg.vitePlugin ?? {}, ...cfg.resolve ? { resolve: cfg.resolve } : {} })
   ];
+  if (cfg.plugins?.length) plugins.push(...cfg.plugins);
   if (cfg.i18n) plugins.push(i18nVitePlugin(cfg.i18n));
-  const { apiRoutesVitePlugin } = await import("./api-4IYNQRKG.mjs");
+  const { apiRoutesVitePlugin } = await import("./api-PBT4QZ34.mjs");
   plugins.push(apiRoutesVitePlugin({ dir: cfg.apiDir }));
   plugins.push(startTypesPlugin(cfg));
   return plugins;
@@ -496,7 +503,12 @@ async function dev(config = {}) {
     // file routing + JSX/SSR transform (fluixi)
     server: { middlewareMode: true, hmr: { server: http } },
     appType: "custom",
-    ssr: cfg.ssrNoExternal.length ? { noExternal: cfg.ssrNoExternal } : void 0
+    // `@fluixi/core` always goes through vite rather than being externalized.
+    // `@fluixi/core/routes` is served by fluixiRoutesPlugin, and an externalized
+    // dependency is imported by node directly, so no plugin ever sees the specifier and
+    // the app gets the "did not replace it" stub instead of its route tree. A workspace
+    // app hides this by resolving the package to source.
+    ssr: { noExternal: ["@fluixi/core", ...cfg.ssrNoExternal] }
   });
   http.listen(cfg.port, () => devReady({ port: cfg.port, startedAt }));
 }

package/dist/commands/index.cjs

@@ -1,4 +1,4 @@
-/*! @fluixi/start v0.1.0-alpha.74 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/start v0.1.0-alpha.76 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -111,7 +111,7 @@ function apiRoutesVitePlugin(opts) {
   return {
     name: "fluixi-api",
     // Must beat node resolution: '@fluixi/start/api-routes' is a real file in this package,
-    // so without `pre` Vite resolves the typed stub and the generated table never loads —
+    // so without `pre` Vite resolves the typed stub and the generated table never loads , 
     // the app builds and every API route 404s.
     enforce: "pre",
     configResolved(config) {
@@ -185,6 +185,8 @@ function resolveConfig(config = {}) {
     middleware: config.middleware ?? "src/middleware.ts",
     ssrNoExternal: config.ssrNoExternal ?? [],
     resolve: config.resolve ?? [],
+    vitePlugin: config.vitePlugin ?? {},
+    plugins: config.plugins ?? [],
     adapter: config.adapter,
     i18n: resolveI18n(config.i18n),
     prerender: resolvePrerender(config.prerender)
@@ -381,7 +383,7 @@ function startTypesPlugin(cfg) {
       const blocks = [];
       if (cfg.i18n) blocks.push(...i18nTypeBlock(root, cfg.i18n));
       if (blocks.length === 0) return;
-      const content = `// Auto-generated by @fluixi/start — do not edit.
+      const content = `// Auto-generated by @fluixi/start, do not edit.
 ${blocks.join("\n")}
 `;
       const file = (0, import_node_path3.resolve)(root, "src/fluixi-start-env.d.ts");
@@ -402,10 +404,15 @@ async function fluixiPlugins(cfg) {
     // app has no way to say where an unimported tag comes from.
     //
     // `fluixi()` and not `createVitePlugin()`: the latter is the bare compiler integration,
-    // and the reactive graph — agent, source marks, /__fluixi/graph — is composed on top of
+    // and the reactive graph: agent, source marks, /__fluixi/graph, is composed on top of
     // it by the former. A start app got no graph at all until this changed.
-    fluixi({ resolve: cfg.resolve })
+    // Everything the app declared for the compiler, with `resolve` still usable on its
+    // own because it is the one most apps set. A start app never writes
+    // `fluixi()` itself, so without this passthrough the plugin's other options
+    // (propsDestructure and the rest) had nowhere to be declared.
+    fluixi({ ...cfg.vitePlugin ?? {}, ...cfg.resolve ? { resolve: cfg.resolve } : {} })
   ];
+  if (cfg.plugins?.length) plugins.push(...cfg.plugins);
   if (cfg.i18n) plugins.push(i18nVitePlugin(cfg.i18n));
   const { apiRoutesVitePlugin: apiRoutesVitePlugin2 } = await Promise.resolve().then(() => (init_api(), api_exports));
   plugins.push(apiRoutesVitePlugin2({ dir: cfg.apiDir }));
@@ -754,7 +761,12 @@ async function dev(config = {}) {
     // file routing + JSX/SSR transform (fluixi)
     server: { middlewareMode: true, hmr: { server: http } },
     appType: "custom",
-    ssr: cfg.ssrNoExternal.length ? { noExternal: cfg.ssrNoExternal } : void 0
+    // `@fluixi/core` always goes through vite rather than being externalized.
+    // `@fluixi/core/routes` is served by fluixiRoutesPlugin, and an externalized
+    // dependency is imported by node directly, so no plugin ever sees the specifier and
+    // the app gets the "did not replace it" stub instead of its route tree. A workspace
+    // app hides this by resolving the package to source.
+    ssr: { noExternal: ["@fluixi/core", ...cfg.ssrNoExternal] }
   });
   http.listen(cfg.port, () => devReady({ port: cfg.port, startedAt }));
 }
@@ -863,14 +875,14 @@ var nodeAdapter = {
 };
 var GENERATED_SUBPATHS = /* @__PURE__ */ new Set(["./routes", "./server-fns", "./api-routes"]);
 function ssrBuildOptions(cfg) {
-  const noExternal = cfg.ssrNoExternal.length ? cfg.ssrNoExternal : void 0;
+  const noExternal = [.../* @__PURE__ */ new Set(["@fluixi/core", ...cfg.ssrNoExternal])];
   const mode = cfg.adapter?.bundle;
   if (mode === "inline") return { noExternal: true };
   if (mode !== "external") return { noExternal };
   const external = frameworkDeps(cfg.root).filter((name) => !cfg.ssrNoExternal.includes(name)).flatMap((name) => withSubpaths(cfg.root, name));
   if (!external.length) {
     console.warn(
-      `  fluixi: adapter "${cfg.adapter?.name}" builds an externalized server, but no fluixi or @fluixi/* dependency was found in ${(0, import_node_path6.join)(cfg.root, "package.json")} — bundling everything.`
+      `  fluixi: adapter "${cfg.adapter?.name}" builds an externalized server, but no fluixi or @fluixi/* dependency was found in ${(0, import_node_path6.join)(cfg.root, "package.json")}, bundling everything.`
     );
   }
   return { noExternal, external: external.length ? external : void 0 };
@@ -1096,7 +1108,7 @@ async function bundleEntry(cfg, plugins, source, outFile) {
           output: {
             entryFileNames: (0, import_node_path8.basename)(outFile),
             // One file, no chunks. A lazy route would otherwise be split out beside
-            // the entry — and for Cloudflare that directory is the published one, so
+            // the entry: and for Cloudflare that directory is the published one, so
             // every server chunk would be a public download.
             inlineDynamicImports: true
           }

package/dist/commands/index.d.ts

@@ -3,7 +3,7 @@
  *
  * Kept off the package root deliberately: these reach the dev server, the build
  * and the prerenderer, and a module that only wants `defineMiddleware` should not
- * be able to pull a bundler in behind it. That matters at build time — a deploy
+ * be able to pull a bundler in behind it. That matters at build time, a deploy
  * adapter inlines everything the entry can reach, and reaching this would put
  * vite in a worker.
  */

package/dist/commands/index.js

@@ -3,7 +3,7 @@
  *
  * Kept off the package root deliberately: these reach the dev server, the build
  * and the prerenderer, and a module that only wants `defineMiddleware` should not
- * be able to pull a bundler in behind it. That matters at build time — a deploy
+ * be able to pull a bundler in behind it. That matters at build time, a deploy
  * adapter inlines everything the entry can reach, and reaching this would put
  * vite in a worker.
  */

package/dist/commands/index.mjs

@@ -1,8 +1,8 @@
-/*! @fluixi/start v0.1.0-alpha.74 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/start v0.1.0-alpha.76 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 import {
   API_VIRTUAL_MODULE,
   isApiPath
-} from "./chunk-OCPCK4ZJ.mjs";
+} from "./chunk-JACRXSN7.mjs";
 
 // src/commands/dev.ts
 import { createServer as createHttp } from "node:http";
@@ -26,6 +26,8 @@ function resolveConfig(config = {}) {
     middleware: config.middleware ?? "src/middleware.ts",
     ssrNoExternal: config.ssrNoExternal ?? [],
     resolve: config.resolve ?? [],
+    vitePlugin: config.vitePlugin ?? {},
+    plugins: config.plugins ?? [],
     adapter: config.adapter,
     i18n: resolveI18n(config.i18n),
     prerender: resolvePrerender(config.prerender)
@@ -222,7 +224,7 @@ function startTypesPlugin(cfg) {
       const blocks = [];
       if (cfg.i18n) blocks.push(...i18nTypeBlock(root, cfg.i18n));
       if (blocks.length === 0) return;
-      const content = `// Auto-generated by @fluixi/start — do not edit.
+      const content = `// Auto-generated by @fluixi/start, do not edit.
 ${blocks.join("\n")}
 `;
       const file = resolvePath(root, "src/fluixi-start-env.d.ts");
@@ -243,12 +245,17 @@ async function fluixiPlugins(cfg) {
     // app has no way to say where an unimported tag comes from.
     //
     // `fluixi()` and not `createVitePlugin()`: the latter is the bare compiler integration,
-    // and the reactive graph — agent, source marks, /__fluixi/graph — is composed on top of
+    // and the reactive graph: agent, source marks, /__fluixi/graph, is composed on top of
     // it by the former. A start app got no graph at all until this changed.
-    fluixi({ resolve: cfg.resolve })
+    // Everything the app declared for the compiler, with `resolve` still usable on its
+    // own because it is the one most apps set. A start app never writes
+    // `fluixi()` itself, so without this passthrough the plugin's other options
+    // (propsDestructure and the rest) had nowhere to be declared.
+    fluixi({ ...cfg.vitePlugin ?? {}, ...cfg.resolve ? { resolve: cfg.resolve } : {} })
   ];
+  if (cfg.plugins?.length) plugins.push(...cfg.plugins);
   if (cfg.i18n) plugins.push(i18nVitePlugin(cfg.i18n));
-  const { apiRoutesVitePlugin } = await import("./api-23MJFSYL.mjs");
+  const { apiRoutesVitePlugin } = await import("./api-LTOLCZPE.mjs");
   plugins.push(apiRoutesVitePlugin({ dir: cfg.apiDir }));
   plugins.push(startTypesPlugin(cfg));
   return plugins;
@@ -592,7 +599,12 @@ async function dev(config = {}) {
     // file routing + JSX/SSR transform (fluixi)
     server: { middlewareMode: true, hmr: { server: http } },
     appType: "custom",
-    ssr: cfg.ssrNoExternal.length ? { noExternal: cfg.ssrNoExternal } : void 0
+    // `@fluixi/core` always goes through vite rather than being externalized.
+    // `@fluixi/core/routes` is served by fluixiRoutesPlugin, and an externalized
+    // dependency is imported by node directly, so no plugin ever sees the specifier and
+    // the app gets the "did not replace it" stub instead of its route tree. A workspace
+    // app hides this by resolving the package to source.
+    ssr: { noExternal: ["@fluixi/core", ...cfg.ssrNoExternal] }
   });
   http.listen(cfg.port, () => devReady({ port: cfg.port, startedAt }));
 }
@@ -701,14 +713,14 @@ var nodeAdapter = {
 };
 var GENERATED_SUBPATHS = /* @__PURE__ */ new Set(["./routes", "./server-fns", "./api-routes"]);
 function ssrBuildOptions(cfg) {
-  const noExternal = cfg.ssrNoExternal.length ? cfg.ssrNoExternal : void 0;
+  const noExternal = [.../* @__PURE__ */ new Set(["@fluixi/core", ...cfg.ssrNoExternal])];
   const mode = cfg.adapter?.bundle;
   if (mode === "inline") return { noExternal: true };
   if (mode !== "external") return { noExternal };
   const external = frameworkDeps(cfg.root).filter((name) => !cfg.ssrNoExternal.includes(name)).flatMap((name) => withSubpaths(cfg.root, name));
   if (!external.length) {
     console.warn(
-      `  fluixi: adapter "${cfg.adapter?.name}" builds an externalized server, but no fluixi or @fluixi/* dependency was found in ${join2(cfg.root, "package.json")} — bundling everything.`
+      `  fluixi: adapter "${cfg.adapter?.name}" builds an externalized server, but no fluixi or @fluixi/* dependency was found in ${join2(cfg.root, "package.json")}, bundling everything.`
     );
   }
   return { noExternal, external: external.length ? external : void 0 };
@@ -934,7 +946,7 @@ async function bundleEntry(cfg, plugins, source, outFile) {
           output: {
             entryFileNames: basename(outFile),
             // One file, no chunks. A lazy route would otherwise be split out beside
-            // the entry — and for Cloudflare that directory is the published one, so
+            // the entry: and for Cloudflare that directory is the published one, so
             // every server chunk would be a public download.
             inlineDynamicImports: true
           }

package/dist/commands/prerender.cjs

@@ -45,6 +45,8 @@ function resolveConfig(config = {}) {
     middleware: config.middleware ?? "src/middleware.ts",
     ssrNoExternal: config.ssrNoExternal ?? [],
     resolve: config.resolve ?? [],
+    vitePlugin: config.vitePlugin ?? {},
+    plugins: config.plugins ?? [],
     adapter: config.adapter,
     i18n: resolveI18n(config.i18n),
     prerender: resolvePrerender(config.prerender)

package/dist/commands/prerender.d.ts

@@ -2,7 +2,7 @@ import type { FluixiConfig } from '../config.js';
 export declare function htmlPath(url: string): string;
 export declare function extractLinks(html: string): string[];
 /**
- * Render routes to static HTML in dist/client, via the real prod handler — so each page is
+ * Render routes to static HTML in dist/client, via the real prod handler, so each page is
  * byte-identical to what `fluixi start` would serve (assets, __FX_DATA__, hydration), it just
  * lives on disk. Seeds from `prerender.routes` (default `/`) and, when `crawl`, follows internal
  * links. Returns the written route paths.

package/dist/commands/prerender.js

@@ -8,7 +8,7 @@ export function htmlPath(url) {
     const clean = url.split(/[?#]/)[0].replace(/\/+$/, '');
     return clean === '' ? 'index.html' : `${clean.replace(/^\//, '')}/index.html`;
 }
-// internal links from rendered HTML — skip files (.js/.css/…), anchors, queries, external
+// internal links from rendered HTML: skip files (.js/.css/…), anchors, queries, external
 export function extractLinks(html) {
     const out = new Set();
     for (const m of html.matchAll(/href=["'](\/[^"'#?]*)["']/g)) {
@@ -24,7 +24,7 @@ const norm = (u) => {
     return p || '/';
 };
 /**
- * Render routes to static HTML in dist/client, via the real prod handler — so each page is
+ * Render routes to static HTML in dist/client, via the real prod handler, so each page is
  * byte-identical to what `fluixi start` would serve (assets, __FX_DATA__, hydration), it just
  * lives on disk. Seeds from `prerender.routes` (default `/`) and, when `crawl`, follows internal
  * links. Returns the written route paths.

package/dist/commands/prerender.mjs

@@ -19,6 +19,8 @@ function resolveConfig(config = {}) {
     middleware: config.middleware ?? "src/middleware.ts",
     ssrNoExternal: config.ssrNoExternal ?? [],
     resolve: config.resolve ?? [],
+    vitePlugin: config.vitePlugin ?? {},
+    plugins: config.plugins ?? [],
     adapter: config.adapter,
     i18n: resolveI18n(config.i18n),
     prerender: resolvePrerender(config.prerender)

package/dist/commands/start.cjs

@@ -52,6 +52,8 @@ function resolveConfig(config = {}) {
     middleware: config.middleware ?? "src/middleware.ts",
     ssrNoExternal: config.ssrNoExternal ?? [],
     resolve: config.resolve ?? [],
+    vitePlugin: config.vitePlugin ?? {},
+    plugins: config.plugins ?? [],
     adapter: config.adapter,
     i18n: resolveI18n(config.i18n),
     prerender: resolvePrerender(config.prerender)

package/dist/commands/start.d.ts

@@ -3,7 +3,7 @@ import type { FluixiConfig } from '../config.js';
  * Production server: build the runtime-neutral SSR fetch handler from the `fluixi
  * build` output and serve it via the Node adapter (static files from dist/client +
  * SSR for everything else). Other runtimes (edge/Bun/Deno) use the same
- * `createProdHandler` with their own adapter — `export default { fetch }`.
+ * `createProdHandler` with their own adapter: `export default { fetch }`.
  */
 export declare function start(config?: FluixiConfig): Promise<void>;
 //# sourceMappingURL=start.d.ts.map

package/dist/commands/start.js

@@ -6,7 +6,7 @@ import { createProdHandler, nodeAdapter } from '../adapter.js';
  * Production server: build the runtime-neutral SSR fetch handler from the `fluixi
  * build` output and serve it via the Node adapter (static files from dist/client +
  * SSR for everything else). Other runtimes (edge/Bun/Deno) use the same
- * `createProdHandler` with their own adapter — `export default { fetch }`.
+ * `createProdHandler` with their own adapter: `export default { fetch }`.
  */
 export async function start(config = {}) {
     const cfg = resolveConfig(config);
@@ -15,7 +15,7 @@ export async function start(config = {}) {
     const clientDir = resolve(cfg.root, 'dist/client');
     const handler = await createProdHandler(cfg);
     // The configured adapter, or node when there is none. An adapter that returns
-    // `{ fetch }` has no process to run — its output is a module the platform imports —
+    // `{ fetch }` has no process to run: its output is a module the platform imports , 
     // so say that instead of exiting as if the server had started.
     const adapter = cfg.adapter ?? nodeAdapter;
     const served = await adapter.serve({ handler, cfg, clientDir });

package/dist/commands/start.mjs

@@ -18,6 +18,8 @@ function resolveConfig(config = {}) {
     middleware: config.middleware ?? "src/middleware.ts",
     ssrNoExternal: config.ssrNoExternal ?? [],
     resolve: config.resolve ?? [],
+    vitePlugin: config.vitePlugin ?? {},
+    plugins: config.plugins ?? [],
     adapter: config.adapter,
     i18n: resolveI18n(config.i18n),
     prerender: resolvePrerender(config.prerender)

package/dist/config.cjs

@@ -1,4 +1,4 @@
-/*! @fluixi/start v0.1.0-alpha.74 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/start v0.1.0-alpha.76 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -40,9 +40,13 @@ var import_node_url = require("node:url");
 var import_node_fs = require("node:fs");
 var import_promises = require("node:fs/promises");
 var import_node_path = require("node:path");
+
+// src/define-config.ts
 function defineConfig(config) {
   return config;
 }
+
+// src/config.ts
 function resolveConfig(config = {}) {
   const root = (0, import_node_path.resolve)(config.root ?? process.cwd());
   return {
@@ -58,6 +62,8 @@ function resolveConfig(config = {}) {
     middleware: config.middleware ?? "src/middleware.ts",
     ssrNoExternal: config.ssrNoExternal ?? [],
     resolve: config.resolve ?? [],
+    vitePlugin: config.vitePlugin ?? {},
+    plugins: config.plugins ?? [],
     adapter: config.adapter,
     i18n: resolveI18n(config.i18n),
     prerender: resolvePrerender(config.prerender)