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

package/dist/commands/{chunk-OCPCK4ZJ.mjs → chunk-GFQ4MUIC.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.75 | (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 }));

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))

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;

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.75 | (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 }));
@@ -870,7 +877,7 @@ function ssrBuildOptions(cfg) {
   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 +1103,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.75 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 import {
   API_VIRTUAL_MODULE,
   isApiPath
-} from "./chunk-OCPCK4ZJ.mjs";
+} from "./chunk-GFQ4MUIC.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-PJL37LV3.mjs");
   plugins.push(apiRoutesVitePlugin({ dir: cfg.apiDir }));
   plugins.push(startTypesPlugin(cfg));
   return plugins;
@@ -708,7 +715,7 @@ function ssrBuildOptions(cfg) {
   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 +941,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.75 | (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)

package/dist/config.d.ts

@@ -2,7 +2,7 @@ import type { Adapter } from './adapter.js';
 import type { ComponentResolverRule } from '@fluixi/compiler';
 /**
  * Fluixi app config. Place in `fluixi.config.{ts,js,mjs}` at the app root and wrap
- * with `defineConfig` for types. Everything is optional — the defaults match the
+ * with `defineConfig` for types. Everything is optional, the defaults match the
  * conventional layout (src/entry-server.ts, src/entry-client.ts, index.html).
  */
 export interface FluixiConfig {
@@ -10,7 +10,7 @@ export interface FluixiConfig {
     root?: string;
     /**
      * Render mode. `true` (default) = SSR: the server entry renders HTML per request. `false`
-     * = SPA: the server serves the static shell and the client renders — but you still get the
+     * = SPA: the server serves the static shell and the client renders, but you still get the
      * full @fluixi/start server (file routing, middleware, env, and `/_server` server functions).
      * The same app code runs either way; flip this to choose where the first paint happens.
      */
@@ -31,7 +31,7 @@ export interface FluixiConfig {
     apiDir?: string;
     /** Request middleware module (default-exports `defineMiddleware([...])`). Default: src/middleware.ts */
     middleware?: string;
-    /** SSR deps Vite must bundle (no-external) — e.g. ESM packages without file extensions. */
+    /** SSR deps Vite must bundle (no-external), e.g. ESM packages without file extensions. */
     ssrNoExternal?: string[];
     /**
      * Where a capitalised tag with no import in scope comes from.
@@ -41,9 +41,26 @@ export interface FluixiConfig {
      * so a whole directory is one rule rather than a list to maintain.
      *
      * Only needed for tags you don't import. A `load:` directive works on your own import
-     * too — see the docs on load strategies.
+     * too: see the docs on load strategies.
      */
     resolve?: readonly ComponentResolverRule[];
+    /**
+     * Options handed to the fluixi vite plugin.
+     *
+     * A start app does not write `fluixi()` into a vite config, the framework adds the
+     * plugin itself, so this is where its options go: `propsDestructure`, and anything
+     * else the compiler takes. `resolve` above is the shorthand for the one most apps
+     * set, and wins over a `resolve` given here.
+     */
+    vitePlugin?: Record<string, unknown>;
+    /**
+     * Extra vite plugins, appended after the framework's own.
+     *
+     * A start app has no vite config of its own, so a plugin it needs but the framework
+     * does not ship, a css engine for instance, is declared here instead of forcing a
+     * second config file into the project.
+     */
+    plugins?: unknown[];
     /**
      * Deploy target. Decides how `fluixi build` bundles the server (see the adapter's
      * `bundle` mode) and how `fluixi start` serves it. Unset keeps Vite's own bundling
@@ -54,7 +71,7 @@ export interface FluixiConfig {
      * Built-in i18n auto-discovery. Scans `<dir>/<locale>.json` and exposes them as
      * `virtual:fluixi-i18n` (`{ messages, locales, defaultLocale }`) to feed `createI18n`.
      * `false` disables it; an object configures the folder / locales / default. Default: enabled
-     * with `src/i18n` — a no-op until that folder has `*.json` files, so it's effectively opt-in.
+     * with `src/i18n`: a no-op until that folder has `*.json` files, so it's effectively opt-in.
      */
     i18n?: boolean | {
         dir?: string;
@@ -91,13 +108,13 @@ export type ResolvedConfig = Required<Omit<FluixiConfig, 'ssrNoExternal' | 'i18n
     adapter?: Adapter;
 };
 /** Identity helper for editor types in `fluixi.config.ts`. */
-export declare function defineConfig(config: FluixiConfig): FluixiConfig;
+export { defineConfig } from './define-config.js';
 /** Apply defaults. */
 export declare function resolveConfig(config?: FluixiConfig): ResolvedConfig;
 /**
  * Load `fluixi.config.{ts,mts,mjs,js}` from the app root. TypeScript configs are
  * bundled on the fly with esbuild and imported; plain ESM is imported directly.
- * No config is fine too — every field has a default.
+ * No config is fine too: every field has a default.
  */
 export declare function loadConfig(root?: string): Promise<FluixiConfig>;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mGAAmG;IACnG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6GAA6G;IAC7G,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wGAAwG;IACxG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2FAA2F;IAC3F,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC3C;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC9E;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC9D;AAED,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,CACnC,IAAI,CAAC,YAAY,EAAE,eAAe,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC,CACvE,GAAG;IACF,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,EAAE,YAAY,GAAG,KAAK,CAAC;IAC3B,SAAS,EAAE,iBAAiB,GAAG,KAAK,CAAC;IACrC,4EAA4E;IAC5E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAE/D;AAED,sBAAsB;AACtB,wBAAgB,aAAa,CAAC,MAAM,GAAE,YAAiB,GAAG,cAAc,CAmBvE;AAgCD;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,IAAI,SAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAM5E"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mGAAmG;IACnG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6GAA6G;IAC7G,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wGAAwG;IACxG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0FAA0F;IAC1F,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC3C;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC9E;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC9D;AAED,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,CACnC,IAAI,CAAC,YAAY,EAAE,eAAe,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC,CACvE,GAAG;IACF,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,EAAE,YAAY,GAAG,KAAK,CAAC;IAC3B,SAAS,EAAE,iBAAiB,GAAG,KAAK,CAAC;IACrC,4EAA4E;IAC5E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,8DAA8D;AAG9D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,sBAAsB;AACtB,wBAAgB,aAAa,CAAC,MAAM,GAAE,YAAiB,GAAG,cAAc,CAqBvE;AAgCD;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,IAAI,SAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAM5E"}

package/dist/config.js

@@ -3,9 +3,9 @@ import { existsSync } from 'node:fs';
 import { writeFile, unlink } from 'node:fs/promises';
 import { resolve, isAbsolute } from 'node:path';
 /** Identity helper for editor types in `fluixi.config.ts`. */
-export function defineConfig(config) {
-    return config;
-}
+// One implementation, re-exported: the root entry needs it without this module's
+// `node:fs`, and two copies of an identity function is how their signatures drift.
+export { defineConfig } from './define-config.js';
 /** Apply defaults. */
 export function resolveConfig(config = {}) {
     const root = resolve(config.root ?? process.cwd());
@@ -22,6 +22,8 @@ export 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),
@@ -59,7 +61,7 @@ const CONFIG_NAMES = [
 /**
  * Load `fluixi.config.{ts,mts,mjs,js}` from the app root. TypeScript configs are
  * bundled on the fly with esbuild and imported; plain ESM is imported directly.
- * No config is fine too — every field has a default.
+ * No config is fine too: every field has a default.
  */
 export async function loadConfig(root = process.cwd()) {
     for (const name of CONFIG_NAMES) {
@@ -70,12 +72,12 @@ export async function loadConfig(root = process.cwd()) {
     return {};
 }
 async function loadConfigFile(file) {
-    // Plain ESM (.mjs/.js) — import directly, no transform needed.
+    // Plain ESM (.mjs/.js), import directly, no transform needed.
     if (!/\.[mc]?ts$/.test(file)) {
         const mod = await import(/* @vite-ignore */ pathToFileURL(file).href);
         return (mod.default ?? mod);
     }
-    // TypeScript — bundle with esbuild, keeping bare specifiers external so
+    // TypeScript: bundle with esbuild, keeping bare specifiers external so
     // `import { defineConfig } from '@fluixi/start'` and node builtins resolve from
     // the app. Relative imports (shared constants, env helpers) ARE bundled in. The
     // output is written to a temp `.mjs` beside the source so those externals resolve

package/dist/config.mjs

@@ -1,13 +1,17 @@
-/*! @fluixi/start v0.1.0-alpha.74 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/start v0.1.0-alpha.75 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 
 // src/config.ts
 import { pathToFileURL } from "node:url";
 import { existsSync } from "node:fs";
 import { writeFile, unlink } from "node:fs/promises";
 import { resolve, isAbsolute } from "node:path";
+
+// src/define-config.ts
 function defineConfig(config) {
   return config;
 }
+
+// src/config.ts
 function resolveConfig(config = {}) {
   const root = resolve(config.root ?? process.cwd());
   return {
@@ -23,6 +27,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/define-config.cjs

@@ -0,0 +1,32 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/define-config.ts
+var define_config_exports = {};
+__export(define_config_exports, {
+  defineConfig: () => defineConfig
+});
+module.exports = __toCommonJS(define_config_exports);
+function defineConfig(config) {
+  return config;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  defineConfig
+});

package/dist/define-config.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `defineConfig`, alone, away from the loader.
+ *
+ * It is an identity function that exists for the types, and it belongs to the root
+ * export because a config file is the first thing an app writes. Keeping it here rather
+ * than in `config.ts` is what lets the root entry stay importable in a browser: that
+ * module reads the filesystem to find and load a config, and a single value imported
+ * from it drags `node:fs` into the client bundle.
+ */
+import type { FluixiConfig } from './config.js';
+export declare function defineConfig(config: FluixiConfig): FluixiConfig;
+//# sourceMappingURL=define-config.d.ts.map