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

package/dist/adapter.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 __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -54,6 +54,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)
@@ -407,7 +409,7 @@ export default {
     // Static first, but only for what is static. ASSETS answers "/" with index.html
     // whether that is a prerendered page or the shell, so asking about every path
     // costs an SSR app its home page. Extension means a file, prerendered means a
-    // page, the rest is the handler's — the rule \`withStaticFiles\` already uses.
+    // page, the rest is the handler's: the rule \`withStaticFiles\` already uses.
     const { pathname } = new URL(request.url);
     if (env && env.ASSETS && (prerendered.has(pathname) || /\\.[^/]+$/.test(pathname))) {
       const asset = await env.ASSETS.fetch(request.clone());
@@ -694,7 +696,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_path4.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_path4.join)(cfg.root, "package.json")}, bundling everything.`
     );
   }
   return { noExternal, external: external.length ? external : void 0 };

package/dist/adapter.d.ts

@@ -10,7 +10,7 @@ export declare function createProdHandler(config?: FluixiConfig): Promise<FetchH
 /**
  * The shell the server renders into.
  *
- * `dist/client/index.html` is it, until the app prerenders `/` — then that path holds a
+ * `dist/client/index.html` is it, until the app prerenders `/`, then that path holds a
  * rendered page and the build stashes the shell in `dist/server/template.html` first.
  * Rendering into the page instead puts the home page's markup and head around every
  * SSR response, and leaves hydration two mount elements to choose between.
@@ -35,7 +35,7 @@ export interface AdapterBuildContext {
     hasServer: boolean;
     /**
      * Bundle a generated entry into one self-contained file. Adapters emit a small
-     * platform entry — the worker's `fetch` export, the function's handler — and this
+     * platform entry: the worker's `fetch` export, the function's handler, and this
      * pulls the server bundle and the template into it, because none of these
      * platforms can resolve a module or read a file at runtime.
      */
@@ -45,7 +45,7 @@ export interface AdapterBuildContext {
  * A deploy target.
  *
  * The runtime-neutral fetch handler is the portable core; an adapter packages it for a
- * platform — how the server is bundled (`bundle`), how it is served in development or
+ * platform: how the server is bundled (`bundle`), how it is served in development or
  * on a long-running host (`serve`), and what a deploy actually needs on disk
  * (`build`): a worker entry, a function manifest, a routing config.
  */
@@ -55,10 +55,10 @@ export interface Adapter {
      * How `fluixi build` bundles the framework into the server output. The choice is a
      * property of the deploy target, not of the app:
      *
-     * - `'external'` — `@fluixi/*` stays as bare imports, resolved from `node_modules` at
+     * - `'external'`: `@fluixi/*` stays as bare imports, resolved from `node_modules` at
      *   runtime. Smaller output, faster build; requires the dependencies to be installed
      *   next to it. Right for a long-running Node/Bun/Deno process.
-     * - `'inline'` — everything is bundled into one self-contained file that resolves
+     * - `'inline'`: everything is bundled into one self-contained file that resolves
      *   nothing at runtime. Right for edge/serverless, where there is no `node_modules`.
      *
      * Unset leaves Vite's own heuristic alone (installed deps external, linked ones bundled).
@@ -73,10 +73,10 @@ export interface Adapter {
      */
     build?(ctx: AdapterBuildContext): Promise<void> | void;
 }
-/** Reference filesystem adapter — Node `http` + static files from dist/client. */
+/** Reference filesystem adapter: Node `http` + static files from dist/client. */
 export declare const nodeAdapter: Adapter;
 export { cloudflareAdapter, netlifyAdapter, vercelAdapter } from './adapters/platforms.js';
-/** Reference edge/web adapter — export `{ fetch }`; the platform serves assets. */
+/** Reference edge/web adapter: export `{ fetch }`; the platform serves assets. */
 export declare const webAdapter: Adapter;
 /**
  * The Vite `ssr` options for a build, given the configured adapter's `bundle` mode.
@@ -91,9 +91,9 @@ export declare const webAdapter: Adapter;
  * only honours an *exact* id in `ssr.external`. A bare package name falls through to a
  * resolvability probe that does not externalize deep imports here, and the result is the
  * worst of both worlds: `@fluixi/core` an import, `@fluixi/core/router` copied into
- * the bundle — two routers, two sets of module state, in one server.
+ * the bundle: two routers, two sets of module state, in one server.
  *
- * `ssrNoExternal` always wins — it is the app saying "this one must be bundled".
+ * `ssrNoExternal` always wins: it is the app saying "this one must be bundled".
  */
 export declare function ssrBuildOptions(cfg: ResolvedConfig): {
     noExternal?: string[] | true;

package/dist/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEhE,OAAO,EAA8B,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAI7E;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,GAAE,YAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAiBxF;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGxF;AAoBD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,YAAY,CAAC;IACtB,GAAG,EAAE,cAAc,CAAC;IACpB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,6EAA6E;AAC7E,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,cAAc,CAAC;IACpB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC/B,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG;QAAE,KAAK,EAAE,YAAY,CAAA;KAAE,CAAC;IACpE;;;OAGG;IACH,KAAK,CAAC,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACxD;AAED,kFAAkF;AAClF,eAAO,MAAM,WAAW,EAAE,OAWzB,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE3F,mFAAmF;AACnF,eAAO,MAAM,UAAU,EAAE,OAQxB,CAAC;AAUF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,cAAc,GAAG;IACpD,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAoBA"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEhE,OAAO,EAA8B,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAI7E;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,GAAE,YAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAiBxF;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGxF;AAoBD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,YAAY,CAAC;IACtB,GAAG,EAAE,cAAc,CAAC;IACpB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,6EAA6E;AAC7E,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,cAAc,CAAC;IACpB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC/B,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG;QAAE,KAAK,EAAE,YAAY,CAAA;KAAE,CAAC;IACpE;;;OAGG;IACH,KAAK,CAAC,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACxD;AAED,iFAAiF;AACjF,eAAO,MAAM,WAAW,EAAE,OAWzB,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE3F,kFAAkF;AAClF,eAAO,MAAM,UAAU,EAAE,OAQxB,CAAC;AAUF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,cAAc,GAAG;IACpD,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAoBA"}

package/dist/adapter.js

@@ -18,7 +18,7 @@ export async function createProdHandler(config = {}) {
     const clientDir = resolve(cfg.root, 'dist/client');
     const template = await readTemplate(clientDir, resolve(cfg.root, 'dist/server'));
     const serverEntry = resolve(cfg.root, 'dist/server', 'entry-server.js');
-    // SPA apps may ship no server entry (or one only for server functions) — import if present.
+    // SPA apps may ship no server entry (or one only for server functions), import if present.
     const mod = existsSync(serverEntry)
         ? await import(/* @vite-ignore */ pathToFileURL(serverEntry).href)
         : {};
@@ -32,7 +32,7 @@ export async function createProdHandler(config = {}) {
 /**
  * The shell the server renders into.
  *
- * `dist/client/index.html` is it, until the app prerenders `/` — then that path holds a
+ * `dist/client/index.html` is it, until the app prerenders `/`, then that path holds a
  * rendered page and the build stashes the shell in `dist/server/template.html` first.
  * Rendering into the page instead puts the home page's markup and head around every
  * SSR response, and leaves hydration two mount elements to choose between.
@@ -59,7 +59,7 @@ async function loadPreloader(cfg) {
         return undefined;
     }
 }
-/** Reference filesystem adapter — Node `http` + static files from dist/client. */
+/** Reference filesystem adapter: Node `http` + static files from dist/client. */
 export const nodeAdapter = {
     name: 'node',
     // A Node server runs from the app directory, so node_modules is right there: keep the
@@ -73,7 +73,7 @@ export const nodeAdapter = {
     },
 };
 export { cloudflareAdapter, netlifyAdapter, vercelAdapter } from './adapters/platforms.js';
-/** Reference edge/web adapter — export `{ fetch }`; the platform serves assets. */
+/** Reference edge/web adapter: export `{ fetch }`; the platform serves assets. */
 export const webAdapter = {
     name: 'web',
     // An edge/serverless runtime uploads a file, not an install: nothing may be left to
@@ -87,7 +87,7 @@ export const webAdapter = {
  * Subpaths that only look like package entries: a Vite plugin replaces them with the
  * app's generated route/server-fn/API tables, and the real file in the package is a stub
  * that throws. Externalizing one would ship the stub. The plugins run with
- * `enforce: 'pre'` so they win anyway — this list is the second lock on that door.
+ * `enforce: 'pre'` so they win anyway: this list is the second lock on that door.
  */
 const GENERATED_SUBPATHS = new Set(['./routes', './server-fns', './api-routes']);
 /**
@@ -103,9 +103,9 @@ const GENERATED_SUBPATHS = new Set(['./routes', './server-fns', './api-routes'])
  * only honours an *exact* id in `ssr.external`. A bare package name falls through to a
  * resolvability probe that does not externalize deep imports here, and the result is the
  * worst of both worlds: `@fluixi/core` an import, `@fluixi/core/router` copied into
- * the bundle — two routers, two sets of module state, in one server.
+ * the bundle: two routers, two sets of module state, in one server.
  *
- * `ssrNoExternal` always wins — it is the app saying "this one must be bundled".
+ * `ssrNoExternal` always wins: it is the app saying "this one must be bundled".
  */
 export function ssrBuildOptions(cfg) {
     const noExternal = cfg.ssrNoExternal.length ? cfg.ssrNoExternal : undefined;
@@ -121,7 +121,7 @@ export function ssrBuildOptions(cfg) {
         // Silently building an inlined bundle here would look identical to a working one
         // until someone measures it, so say why nothing was externalized.
         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 or @fluixi/* dependency was found in ${join(cfg.root, 'package.json')}, bundling everything.`);
     }
     return { noExternal, external: external.length ? external : undefined };
 }
@@ -136,7 +136,7 @@ function frameworkDeps(root) {
     return Object.keys(declared).filter((id) => id === '@fluixi/core' || id.startsWith('@fluixi/'));
 }
 /**
- * `['@fluixi/core', '@fluixi/core/router', …]` — the package plus every static subpath it
+ * `['@fluixi/core', '@fluixi/core/router', …]`: the package plus every static subpath it
  * exports. Wildcard entries (`./lib/*`) cannot be enumerated and are left to Vite; an
  * app importing through one gets it bundled, which is the safe direction.
  */
@@ -164,7 +164,7 @@ function resolvePackage(root, name) {
         return readPackage(createRequire(join(root, 'index.js')).resolve(`${name}/package.json`));
     }
     catch {
-        /* not exported — fall through */
+        /* not exported: fall through */
     }
     for (let dir = root;; dir = dirname(dir)) {
         const pkg = readPackage(join(dir, 'node_modules', name, 'package.json'));

package/dist/adapter.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/adapter.ts
 import { readFile as readFile2 } from "node:fs/promises";
@@ -24,6 +24,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)
@@ -377,7 +379,7 @@ export default {
     // Static first, but only for what is static. ASSETS answers "/" with index.html
     // whether that is a prerendered page or the shell, so asking about every path
     // costs an SSR app its home page. Extension means a file, prerendered means a
-    // page, the rest is the handler's — the rule \`withStaticFiles\` already uses.
+    // page, the rest is the handler's: the rule \`withStaticFiles\` already uses.
     const { pathname } = new URL(request.url);
     if (env && env.ASSETS && (prerendered.has(pathname) || /\\.[^/]+$/.test(pathname))) {
       const asset = await env.ASSETS.fetch(request.clone());
@@ -664,7 +666,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 ${join3(cfg.root, "package.json")} — bundling everything.`
+      `  fluixi: adapter "${cfg.adapter?.name}" builds an externalized server, but no fluixi or @fluixi/* dependency was found in ${join3(cfg.root, "package.json")}, bundling everything.`
     );
   }
   return { noExternal, external: external.length ? external : void 0 };

package/dist/adapters/entry.cjs

@@ -55,7 +55,7 @@ export default {
     // Static first, but only for what is static. ASSETS answers "/" with index.html
     // whether that is a prerendered page or the shell, so asking about every path
     // costs an SSR app its home page. Extension means a file, prerendered means a
-    // page, the rest is the handler's — the rule \`withStaticFiles\` already uses.
+    // page, the rest is the handler's: the rule \`withStaticFiles\` already uses.
     const { pathname } = new URL(request.url);
     if (env && env.ASSETS && (prerendered.has(pathname) || /\\.[^/]+$/.test(pathname))) {
       const asset = await env.ASSETS.fetch(request.clone());

package/dist/adapters/entry.js

@@ -49,7 +49,7 @@ export default {
     // Static first, but only for what is static. ASSETS answers "/" with index.html
     // whether that is a prerendered page or the shell, so asking about every path
     // costs an SSR app its home page. Extension means a file, prerendered means a
-    // page, the rest is the handler's — the rule \`withStaticFiles\` already uses.
+    // page, the rest is the handler's: the rule \`withStaticFiles\` already uses.
     const { pathname } = new URL(request.url);
     if (env && env.ASSETS && (prerendered.has(pathname) || /\\.[^/]+$/.test(pathname))) {
       const asset = await env.ASSETS.fetch(request.clone());

package/dist/adapters/entry.mjs

@@ -29,7 +29,7 @@ export default {
     // Static first, but only for what is static. ASSETS answers "/" with index.html
     // whether that is a prerendered page or the shell, so asking about every path
     // costs an SSR app its home page. Extension means a file, prerendered means a
-    // page, the rest is the handler's — the rule \`withStaticFiles\` already uses.
+    // page, the rest is the handler's: the rule \`withStaticFiles\` already uses.
     const { pathname } = new URL(request.url);
     if (env && env.ASSETS && (prerendered.has(pathname) || /\\.[^/]+$/.test(pathname))) {
       const asset = await env.ASSETS.fetch(request.clone());

package/dist/adapters/platforms.cjs

@@ -77,7 +77,7 @@ export default {
     // Static first, but only for what is static. ASSETS answers "/" with index.html
     // whether that is a prerendered page or the shell, so asking about every path
     // costs an SSR app its home page. Extension means a file, prerendered means a
-    // page, the rest is the handler's — the rule \`withStaticFiles\` already uses.
+    // page, the rest is the handler's: the rule \`withStaticFiles\` already uses.
     const { pathname } = new URL(request.url);
     if (env && env.ASSETS && (prerendered.has(pathname) || /\\.[^/]+$/.test(pathname))) {
       const asset = await env.ASSETS.fetch(request.clone());

package/dist/adapters/platforms.d.ts

@@ -3,7 +3,7 @@ import { type Adapter } from '../adapter.js';
  * Cloudflare Pages. `_worker.js` at the root of the published directory takes every
  * request; `_routes.json` is what decides whether a request costs an invocation.
  *
- * In advanced mode the worker sees everything not excluded — so a prerendered page
+ * In advanced mode the worker sees everything not excluded, so a prerendered page
  * would wake it just to proxy the file back through the ASSETS binding. On a plan
  * metered by request that is the whole page view budget spent on static files, so
  * every prerendered path is excluded by name.
@@ -13,7 +13,7 @@ import { type Adapter } from '../adapter.js';
 export declare const cloudflareAdapter: Adapter;
 /**
  * Netlify. The function is a v2 fetch handler under `.netlify/functions-internal/`,
- * which is where a framework — as opposed to the user — puts one, so it cannot
+ * which is where a framework: as opposed to the user, puts one, so it cannot
  * collide with the app's own `netlify/functions`.
  *
  * Publish `dist/client`.

package/dist/adapters/platforms.js

@@ -2,7 +2,7 @@
  * Deploy adapters for the three hosts that expect a specific output layout.
  *
  * Each one bundles the same generated entry and then writes whatever the platform
- * reads to route a request. What differs is only that layout — the handler, the
+ * reads to route a request. What differs is only that layout, the handler, the
  * dispatch order and the render are shared.
  *
  * All three inline the framework: a worker or a serverless function is a file that
@@ -40,7 +40,7 @@ async function entrySource(ctx, from, prerendered) {
  * Is `dist/client/index.html` a page, or the shell the server renders into?
  *
  * Vite writes the shell at the path a prerendered `/` would occupy, and every one of
- * these platforms serves a matching file before invoking anything — so `/` is the one
+ * these platforms serves a matching file before invoking anything, so `/` is the one
  * route an SSR app cannot render, and the CDN answers it with an empty mount element.
  * No other route is affected: nothing exists at `/about` unless it was prerendered.
  */
@@ -59,7 +59,7 @@ function skipWhenStatic(ctx, name) {
 }
 /**
  * Add a rule to `_redirects` without taking the file over. Apps ship their own (the
- * docs site redirects `/` to its default locale), so ours goes last — first match
+ * docs site redirects `/` to its default locale), so ours goes last, first match
  * wins, so the app's rules are reached first.
  */
 async function appendRedirect(clientDir, rule) {
@@ -112,7 +112,7 @@ async function prerenderedRoutes(dir, mountId) {
  * Cloudflare Pages. `_worker.js` at the root of the published directory takes every
  * request; `_routes.json` is what decides whether a request costs an invocation.
  *
- * In advanced mode the worker sees everything not excluded — so a prerendered page
+ * In advanced mode the worker sees everything not excluded, so a prerendered page
  * would wake it just to proxy the file back through the ASSETS binding. On a plan
  * metered by request that is the whole page view budget spent on static files, so
  * every prerendered path is excluded by name.
@@ -133,13 +133,13 @@ export const cloudflareAdapter = {
         await ctx.bundleEntry(cloudflareEntry(await entrySource(ctx, out, prerendered)), out);
         // Everything under /assets is content-hashed and immutable, so it never needs the
         // worker. `_worker.js` itself must be excluded or Pages would route it to itself.
-        // `/` is excluded only when it was prerendered — otherwise the worker is the only
+        // `/` is excluded only when it was prerendered, otherwise the worker is the only
         // thing that can answer it, and excluding it would serve the shell instead.
         const base = ['/assets/*', '/_worker.js'];
         const room = CF_MAX_RULES - base.length;
         const exclude = [...base, ...prerendered.slice(0, room)];
         if (prerendered.length > room) {
-            // Past the cap the remainder still works — it just wakes the worker to hand
+            // Past the cap the remainder still works: it just wakes the worker to hand
             // back a file. Worth saying, because the symptom is a bill, not an error.
             console.warn(`  fluixi: ${prerendered.length} prerendered routes exceed Cloudflare's ${CF_MAX_RULES}-rule ` +
                 `limit for _routes.json; ${prerendered.length - room} will invoke the worker to serve a static file.`);
@@ -149,7 +149,7 @@ export const cloudflareAdapter = {
 };
 /**
  * Netlify. The function is a v2 fetch handler under `.netlify/functions-internal/`,
- * which is where a framework — as opposed to the user — puts one, so it cannot
+ * which is where a framework: as opposed to the user, puts one, so it cannot
  * collide with the app's own `netlify/functions`.
  *
  * Publish `dist/client`.
@@ -173,7 +173,7 @@ export const netlifyAdapter = {
         // load an internal function at all.
         await writeFile(join(dir, 'fluixi-server.json'), JSON.stringify({ config: { path: '/*', preferStatic: true }, version: 1 }, null, 2) + '\n');
         // `preferStatic` is what keeps assets, prerendered pages and files like
-        // `favicon.ico` off the function — and it is also what would hand back the shell
+        // `favicon.ico` off the function: and it is also what would hand back the shell
         // for `/`. A forced redirect is the one exception the CDN honours over a file, so
         // it claims exactly that path and nothing else. Appended, so an app's own rules in
         // `public/_redirects` still match first.

package/dist/adapters/platforms.mjs

@@ -51,7 +51,7 @@ export default {
     // Static first, but only for what is static. ASSETS answers "/" with index.html
     // whether that is a prerendered page or the shell, so asking about every path
     // costs an SSR app its home page. Extension means a file, prerendered means a
-    // page, the rest is the handler's — the rule \`withStaticFiles\` already uses.
+    // page, the rest is the handler's: the rule \`withStaticFiles\` already uses.
     const { pathname } = new URL(request.url);
     if (env && env.ASSETS && (prerendered.has(pathname) || /\\.[^/]+$/.test(pathname))) {
       const asset = await env.ASSETS.fetch(request.clone());

package/dist/{api-RH6E5UTH.mjs → api-HD7KU3BS.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/api.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 __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -103,7 +103,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/api.js

@@ -91,7 +91,7 @@ export 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/api.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/{api-RH6E5UTH.mjs → api-HD7KU3BS.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/{api-4IYNQRKG.mjs → api-PBT4QZ34.mjs}

@@ -5,7 +5,7 @@ import {
   handleApi,
   isApiPath,
   matchApiRoutes
-} from "./chunk-NS5GR2GX.mjs";
+} from "./chunk-MTM6M3TC.mjs";
 export {
   API_VIRTUAL_MODULE,
   apiRoutesVitePlugin,

package/dist/commands/{api-23MJFSYL.mjs → api-PJL37LV3.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 */
 import {
   API_VIRTUAL_MODULE,
   apiRoutesVitePlugin,
@@ -6,7 +6,7 @@ import {
   handleApi,
   isApiPath,
   matchApiRoutes
-} from "./chunk-OCPCK4ZJ.mjs";
+} from "./chunk-GFQ4MUIC.mjs";
 export {
   API_VIRTUAL_MODULE,
   apiRoutesVitePlugin,

package/dist/commands/build.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)
@@ -374,7 +376,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");
@@ -395,10 +397,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 }));
@@ -567,7 +574,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_path4.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_path4.join)(cfg.root, "package.json")}, bundling everything.`
     );
   }
   return { noExternal, external: external.length ? external : void 0 };
@@ -848,7 +855,7 @@ async function bundleEntry(cfg, plugins, source, outFile) {
           output: {
             entryFileNames: (0, import_node_path6.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/build.js

@@ -27,8 +27,8 @@ export async function build(config = {}) {
         logLevel: 'warn',
         build: { outDir: 'dist/client', ssrManifest: true, emptyOutDir: true },
     });
-    // SSR builds a server bundle that renders HTML. A SPA may still ship one — only for server
-    // functions / middleware — so build it when the entry exists; a pure static SPA skips it.
+    // SSR builds a server bundle that renders HTML. A SPA may still ship one, only for server
+    // functions / middleware: so build it when the entry exists; a pure static SPA skips it.
     const serverEntrySrc = resolve(cfg.root, cfg.serverEntry);
     if (cfg.ssr || existsSync(serverEntrySrc)) {
         step(`server bundle${bundleNote(cfg)}`);
@@ -71,7 +71,7 @@ export async function build(config = {}) {
         process.stdout.write('\n');
         await prerender(config);
     }
-    // The deploy target's own output layout — a worker entry, a function manifest, a
+    // The deploy target's own output layout: a worker entry, a function manifest, a
     // routing config. Last, so everything it wraps or copies already exists.
     if (cfg.adapter?.build) {
         step(`${cfg.adapter.name} output`);
@@ -132,7 +132,7 @@ async function collectRouteAssets(cfg) {
  * Bundle a generated platform entry into one self-contained file.
  *
  * The entry is written next to its output so a relative import of the server bundle
- * resolves, then removed — a stray `.fluixi-entry.js` in dist would be served as a
+ * resolves, then removed: a stray `.fluixi-entry.js` in dist would be served as a
  * static asset on every one of these platforms.
  */
 async function bundleEntry(cfg, plugins, source, outFile) {
@@ -156,7 +156,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,
                     },
@@ -168,7 +168,7 @@ async function bundleEntry(cfg, plugins, source, outFile) {
         await rm(temp, { force: true });
     }
 }
-/** `server bundle (node · external)` — the output shape is not obvious from the file. */
+/** `server bundle (node · external)`: the output shape is not obvious from the file. */
 function bundleNote(cfg) {
     const adapter = cfg.adapter;
     if (!adapter?.bundle)

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;
@@ -408,7 +415,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 ${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
           }