@tanstack/start-plugin-core 1.169.0 → 1.169.2

package/dist/esm/vite/schema.d.ts

@@ -209,20 +209,25 @@ export declare const tanstackStartViteOptionsSchema: z.ZodDefault<z.ZodOptional<
         entry: z.ZodOptional<z.ZodString>;
         build: z.ZodDefault<z.ZodOptional<z.ZodObject<{
             staticNodeEnv: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            inlineCss: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         }, "strip", z.ZodTypeAny, {
             staticNodeEnv: boolean;
+            inlineCss: boolean;
         }, {
             staticNodeEnv?: boolean | undefined;
+            inlineCss?: boolean | undefined;
         }>>>;
     }, "strip", z.ZodTypeAny, {
         build: {
             staticNodeEnv: boolean;
+            inlineCss: boolean;
         };
         entry?: string | undefined;
     }, {
         entry?: string | undefined;
         build?: {
             staticNodeEnv?: boolean | undefined;
+            inlineCss?: boolean | undefined;
         } | undefined;
     }>>>;
     serverFns: z.ZodDefault<z.ZodOptional<z.ZodObject<{
@@ -2391,6 +2396,7 @@ export declare const tanstackStartViteOptionsSchema: z.ZodDefault<z.ZodOptional<
     server: {
         build: {
             staticNodeEnv: boolean;
+            inlineCss: boolean;
         };
         entry?: string | undefined;
     };
@@ -2720,6 +2726,7 @@ export declare const tanstackStartViteOptionsSchema: z.ZodDefault<z.ZodOptional<
         entry?: string | undefined;
         build?: {
             staticNodeEnv?: boolean | undefined;
+            inlineCss?: boolean | undefined;
         } | undefined;
     } | undefined;
     srcDirectory?: string | undefined;
@@ -3099,6 +3106,7 @@ export declare function parseStartConfig(opts: z.input<typeof tanstackStartViteO
     server: {
         build: {
             staticNodeEnv: boolean;
+            inlineCss: boolean;
         };
         entry?: string | undefined;
     };

package/dist/esm/vite/start-manifest-plugin/normalized-client-build.js

@@ -1,3 +1,4 @@
+import { getCssAssetSource } from "../../start-manifest-plugin/inlineCss.js";
 import { tsrSplit } from "@tanstack/router-plugin";
 //#region src/vite/start-manifest-plugin/normalized-client-build.ts
 function normalizeViteClientChunk(chunk) {
@@ -25,6 +26,7 @@ function normalizeViteClientBuild(clientBundle) {
 	const chunksByFileName = normalizeViteClientChunks(clientBundle);
 	const chunkFileNamesByRouteFilePath = /* @__PURE__ */ new Map();
 	const cssFilesBySourcePath = /* @__PURE__ */ new Map();
+	const cssContentByFileName = /* @__PURE__ */ new Map();
 	for (const chunk of chunksByFileName.values()) {
 		const bundleEntry = clientBundle[chunk.fileName];
 		if (chunk.isEntry) {
@@ -47,12 +49,20 @@ function normalizeViteClientBuild(clientBundle) {
 			cssFilesBySourcePath.set(sourcePath, existing ? Array.from(new Set([...existing, ...chunk.css])) : chunk.css.slice());
 		}
 	}
+	for (const fileName in clientBundle) {
+		if (!fileName.endsWith(".css")) continue;
+		const bundleEntry = clientBundle[fileName];
+		if (bundleEntry.type !== "asset") continue;
+		const css = getCssAssetSource(bundleEntry.source);
+		if (css !== void 0) cssContentByFileName.set(fileName, css);
+	}
 	if (!entryChunkFileName) throw new Error("No entry file found");
 	return {
 		entryChunkFileName,
 		chunksByFileName,
 		chunkFileNamesByRouteFilePath,
-		cssFilesBySourcePath
+		cssFilesBySourcePath,
+		cssContentByFileName
 	};
 }
 function getRouteFilePathsFromModuleIds(moduleIds) {

package/dist/esm/vite/start-manifest-plugin/normalized-client-build.js.map

@@ -1 +1 @@
-{"version":3,"file":"normalized-client-build.js","names":[],"sources":["../../../../src/vite/start-manifest-plugin/normalized-client-build.ts"],"sourcesContent":["import { tsrSplit } from '@tanstack/router-plugin'\nimport type { Rollup } from 'vite'\nimport type { NormalizedClientBuild, NormalizedClientChunk } from '../../types'\n\nexport function normalizeViteClientChunk(\n  chunk: Rollup.OutputChunk,\n): NormalizedClientChunk {\n  return {\n    fileName: chunk.fileName,\n    isEntry: chunk.isEntry,\n    imports: chunk.imports,\n    dynamicImports: chunk.dynamicImports,\n    css: Array.from(chunk.viteMetadata?.importedCss ?? []),\n    routeFilePaths: getRouteFilePathsFromModuleIds(chunk.moduleIds),\n  }\n}\n\nexport function normalizeViteClientChunks(\n  clientBundle: Rollup.OutputBundle,\n): ReadonlyMap<string, NormalizedClientChunk> {\n  const chunksByFileName = new Map<string, NormalizedClientChunk>()\n\n  for (const fileName in clientBundle) {\n    const bundleEntry = clientBundle[fileName]!\n    if (bundleEntry.type !== 'chunk') {\n      continue\n    }\n\n    const normalizedChunk = normalizeViteClientChunk(bundleEntry)\n    chunksByFileName.set(normalizedChunk.fileName, normalizedChunk)\n  }\n\n  return chunksByFileName\n}\n\nexport function normalizeViteClientBuild(\n  clientBundle: Rollup.OutputBundle,\n): NormalizedClientBuild {\n  let entryChunkFileName: string | undefined\n  const chunksByFileName = normalizeViteClientChunks(clientBundle)\n  const chunkFileNamesByRouteFilePath = new Map<string, Array<string>>()\n  const cssFilesBySourcePath = new Map<string, Array<string>>()\n\n  for (const chunk of chunksByFileName.values()) {\n    const bundleEntry = clientBundle[chunk.fileName] as Rollup.OutputChunk\n\n    if (chunk.isEntry) {\n      if (entryChunkFileName) {\n        throw new Error(\n          `multiple entries detected: ${entryChunkFileName} ${chunk.fileName}`,\n        )\n      }\n      entryChunkFileName = chunk.fileName\n    }\n\n    for (const routeFilePath of chunk.routeFilePaths) {\n      let chunkFileNames = chunkFileNamesByRouteFilePath.get(routeFilePath)\n      if (chunkFileNames === undefined) {\n        chunkFileNames = []\n        chunkFileNamesByRouteFilePath.set(routeFilePath, chunkFileNames)\n      }\n      chunkFileNames.push(chunk.fileName)\n    }\n\n    for (const moduleId of bundleEntry.moduleIds) {\n      const queryIndex = moduleId.indexOf('?')\n      const sourcePath =\n        queryIndex >= 0 ? moduleId.slice(0, queryIndex) : moduleId\n      if (!sourcePath) continue\n\n      const existing = cssFilesBySourcePath.get(sourcePath)\n      cssFilesBySourcePath.set(\n        sourcePath,\n        existing\n          ? Array.from(new Set([...existing, ...chunk.css]))\n          : chunk.css.slice(),\n      )\n    }\n  }\n\n  if (!entryChunkFileName) {\n    throw new Error('No entry file found')\n  }\n\n  return {\n    entryChunkFileName,\n    chunksByFileName,\n    chunkFileNamesByRouteFilePath,\n    cssFilesBySourcePath,\n  }\n}\n\nexport function getRouteFilePathsFromModuleIds(moduleIds: Array<string>) {\n  let routeFilePaths: Array<string> | undefined\n  let seenRouteFilePaths: Set<string> | undefined\n\n  for (const moduleId of moduleIds) {\n    const queryIndex = moduleId.indexOf('?')\n\n    if (queryIndex < 0) {\n      continue\n    }\n\n    const query = moduleId.slice(queryIndex + 1)\n\n    if (!query.includes(tsrSplit)) {\n      continue\n    }\n\n    if (!new URLSearchParams(query).has(tsrSplit)) {\n      continue\n    }\n\n    const routeFilePath = moduleId.slice(0, queryIndex)\n\n    if (seenRouteFilePaths?.has(routeFilePath)) {\n      continue\n    }\n\n    if (routeFilePaths === undefined || seenRouteFilePaths === undefined) {\n      routeFilePaths = []\n      seenRouteFilePaths = new Set<string>()\n    }\n\n    routeFilePaths.push(routeFilePath)\n    seenRouteFilePaths.add(routeFilePath)\n  }\n\n  return routeFilePaths ?? []\n}\n"],"mappings":";;AAIA,SAAgB,yBACd,OACuB;AACvB,QAAO;EACL,UAAU,MAAM;EAChB,SAAS,MAAM;EACf,SAAS,MAAM;EACf,gBAAgB,MAAM;EACtB,KAAK,MAAM,KAAK,MAAM,cAAc,eAAe,EAAE,CAAC;EACtD,gBAAgB,+BAA+B,MAAM,UAAU;EAChE;;AAGH,SAAgB,0BACd,cAC4C;CAC5C,MAAM,mCAAmB,IAAI,KAAoC;AAEjE,MAAK,MAAM,YAAY,cAAc;EACnC,MAAM,cAAc,aAAa;AACjC,MAAI,YAAY,SAAS,QACvB;EAGF,MAAM,kBAAkB,yBAAyB,YAAY;AAC7D,mBAAiB,IAAI,gBAAgB,UAAU,gBAAgB;;AAGjE,QAAO;;AAGT,SAAgB,yBACd,cACuB;CACvB,IAAI;CACJ,MAAM,mBAAmB,0BAA0B,aAAa;CAChE,MAAM,gDAAgC,IAAI,KAA4B;CACtE,MAAM,uCAAuB,IAAI,KAA4B;AAE7D,MAAK,MAAM,SAAS,iBAAiB,QAAQ,EAAE;EAC7C,MAAM,cAAc,aAAa,MAAM;AAEvC,MAAI,MAAM,SAAS;AACjB,OAAI,mBACF,OAAM,IAAI,MACR,8BAA8B,mBAAmB,GAAG,MAAM,WAC3D;AAEH,wBAAqB,MAAM;;AAG7B,OAAK,MAAM,iBAAiB,MAAM,gBAAgB;GAChD,IAAI,iBAAiB,8BAA8B,IAAI,cAAc;AACrE,OAAI,mBAAmB,KAAA,GAAW;AAChC,qBAAiB,EAAE;AACnB,kCAA8B,IAAI,eAAe,eAAe;;AAElE,kBAAe,KAAK,MAAM,SAAS;;AAGrC,OAAK,MAAM,YAAY,YAAY,WAAW;GAC5C,MAAM,aAAa,SAAS,QAAQ,IAAI;GACxC,MAAM,aACJ,cAAc,IAAI,SAAS,MAAM,GAAG,WAAW,GAAG;AACpD,OAAI,CAAC,WAAY;GAEjB,MAAM,WAAW,qBAAqB,IAAI,WAAW;AACrD,wBAAqB,IACnB,YACA,WACI,MAAM,KAAK,IAAI,IAAI,CAAC,GAAG,UAAU,GAAG,MAAM,IAAI,CAAC,CAAC,GAChD,MAAM,IAAI,OAAO,CACtB;;;AAIL,KAAI,CAAC,mBACH,OAAM,IAAI,MAAM,sBAAsB;AAGxC,QAAO;EACL;EACA;EACA;EACA;EACD;;AAGH,SAAgB,+BAA+B,WAA0B;CACvE,IAAI;CACJ,IAAI;AAEJ,MAAK,MAAM,YAAY,WAAW;EAChC,MAAM,aAAa,SAAS,QAAQ,IAAI;AAExC,MAAI,aAAa,EACf;EAGF,MAAM,QAAQ,SAAS,MAAM,aAAa,EAAE;AAE5C,MAAI,CAAC,MAAM,SAAS,SAAS,CAC3B;AAGF,MAAI,CAAC,IAAI,gBAAgB,MAAM,CAAC,IAAI,SAAS,CAC3C;EAGF,MAAM,gBAAgB,SAAS,MAAM,GAAG,WAAW;AAEnD,MAAI,oBAAoB,IAAI,cAAc,CACxC;AAGF,MAAI,mBAAmB,KAAA,KAAa,uBAAuB,KAAA,GAAW;AACpE,oBAAiB,EAAE;AACnB,wCAAqB,IAAI,KAAa;;AAGxC,iBAAe,KAAK,cAAc;AAClC,qBAAmB,IAAI,cAAc;;AAGvC,QAAO,kBAAkB,EAAE"}
+{"version":3,"file":"normalized-client-build.js","names":[],"sources":["../../../../src/vite/start-manifest-plugin/normalized-client-build.ts"],"sourcesContent":["import { tsrSplit } from '@tanstack/router-plugin'\nimport { getCssAssetSource } from '../../start-manifest-plugin/inlineCss'\nimport type { Rollup } from 'vite'\nimport type { NormalizedClientBuild, NormalizedClientChunk } from '../../types'\n\nexport function normalizeViteClientChunk(\n  chunk: Rollup.OutputChunk,\n): NormalizedClientChunk {\n  return {\n    fileName: chunk.fileName,\n    isEntry: chunk.isEntry,\n    imports: chunk.imports,\n    dynamicImports: chunk.dynamicImports,\n    css: Array.from(chunk.viteMetadata?.importedCss ?? []),\n    routeFilePaths: getRouteFilePathsFromModuleIds(chunk.moduleIds),\n  }\n}\n\nexport function normalizeViteClientChunks(\n  clientBundle: Rollup.OutputBundle,\n): ReadonlyMap<string, NormalizedClientChunk> {\n  const chunksByFileName = new Map<string, NormalizedClientChunk>()\n\n  for (const fileName in clientBundle) {\n    const bundleEntry = clientBundle[fileName]!\n    if (bundleEntry.type !== 'chunk') {\n      continue\n    }\n\n    const normalizedChunk = normalizeViteClientChunk(bundleEntry)\n    chunksByFileName.set(normalizedChunk.fileName, normalizedChunk)\n  }\n\n  return chunksByFileName\n}\n\nexport function normalizeViteClientBuild(\n  clientBundle: Rollup.OutputBundle,\n): NormalizedClientBuild {\n  let entryChunkFileName: string | undefined\n  const chunksByFileName = normalizeViteClientChunks(clientBundle)\n  const chunkFileNamesByRouteFilePath = new Map<string, Array<string>>()\n  const cssFilesBySourcePath = new Map<string, Array<string>>()\n  const cssContentByFileName = new Map<string, string>()\n\n  for (const chunk of chunksByFileName.values()) {\n    const bundleEntry = clientBundle[chunk.fileName] as Rollup.OutputChunk\n\n    if (chunk.isEntry) {\n      if (entryChunkFileName) {\n        throw new Error(\n          `multiple entries detected: ${entryChunkFileName} ${chunk.fileName}`,\n        )\n      }\n      entryChunkFileName = chunk.fileName\n    }\n\n    for (const routeFilePath of chunk.routeFilePaths) {\n      let chunkFileNames = chunkFileNamesByRouteFilePath.get(routeFilePath)\n      if (chunkFileNames === undefined) {\n        chunkFileNames = []\n        chunkFileNamesByRouteFilePath.set(routeFilePath, chunkFileNames)\n      }\n      chunkFileNames.push(chunk.fileName)\n    }\n\n    for (const moduleId of bundleEntry.moduleIds) {\n      const queryIndex = moduleId.indexOf('?')\n      const sourcePath =\n        queryIndex >= 0 ? moduleId.slice(0, queryIndex) : moduleId\n      if (!sourcePath) continue\n\n      const existing = cssFilesBySourcePath.get(sourcePath)\n      cssFilesBySourcePath.set(\n        sourcePath,\n        existing\n          ? Array.from(new Set([...existing, ...chunk.css]))\n          : chunk.css.slice(),\n      )\n    }\n  }\n\n  for (const fileName in clientBundle) {\n    if (!fileName.endsWith('.css')) {\n      continue\n    }\n\n    const bundleEntry = clientBundle[fileName]!\n    if (bundleEntry.type !== 'asset') {\n      continue\n    }\n\n    const css = getCssAssetSource(bundleEntry.source)\n    if (css !== undefined) {\n      cssContentByFileName.set(fileName, css)\n    }\n  }\n\n  if (!entryChunkFileName) {\n    throw new Error('No entry file found')\n  }\n\n  return {\n    entryChunkFileName,\n    chunksByFileName,\n    chunkFileNamesByRouteFilePath,\n    cssFilesBySourcePath,\n    cssContentByFileName,\n  }\n}\n\nexport function getRouteFilePathsFromModuleIds(moduleIds: Array<string>) {\n  let routeFilePaths: Array<string> | undefined\n  let seenRouteFilePaths: Set<string> | undefined\n\n  for (const moduleId of moduleIds) {\n    const queryIndex = moduleId.indexOf('?')\n\n    if (queryIndex < 0) {\n      continue\n    }\n\n    const query = moduleId.slice(queryIndex + 1)\n\n    if (!query.includes(tsrSplit)) {\n      continue\n    }\n\n    if (!new URLSearchParams(query).has(tsrSplit)) {\n      continue\n    }\n\n    const routeFilePath = moduleId.slice(0, queryIndex)\n\n    if (seenRouteFilePaths?.has(routeFilePath)) {\n      continue\n    }\n\n    if (routeFilePaths === undefined || seenRouteFilePaths === undefined) {\n      routeFilePaths = []\n      seenRouteFilePaths = new Set<string>()\n    }\n\n    routeFilePaths.push(routeFilePath)\n    seenRouteFilePaths.add(routeFilePath)\n  }\n\n  return routeFilePaths ?? []\n}\n"],"mappings":";;;AAKA,SAAgB,yBACd,OACuB;AACvB,QAAO;EACL,UAAU,MAAM;EAChB,SAAS,MAAM;EACf,SAAS,MAAM;EACf,gBAAgB,MAAM;EACtB,KAAK,MAAM,KAAK,MAAM,cAAc,eAAe,EAAE,CAAC;EACtD,gBAAgB,+BAA+B,MAAM,UAAU;EAChE;;AAGH,SAAgB,0BACd,cAC4C;CAC5C,MAAM,mCAAmB,IAAI,KAAoC;AAEjE,MAAK,MAAM,YAAY,cAAc;EACnC,MAAM,cAAc,aAAa;AACjC,MAAI,YAAY,SAAS,QACvB;EAGF,MAAM,kBAAkB,yBAAyB,YAAY;AAC7D,mBAAiB,IAAI,gBAAgB,UAAU,gBAAgB;;AAGjE,QAAO;;AAGT,SAAgB,yBACd,cACuB;CACvB,IAAI;CACJ,MAAM,mBAAmB,0BAA0B,aAAa;CAChE,MAAM,gDAAgC,IAAI,KAA4B;CACtE,MAAM,uCAAuB,IAAI,KAA4B;CAC7D,MAAM,uCAAuB,IAAI,KAAqB;AAEtD,MAAK,MAAM,SAAS,iBAAiB,QAAQ,EAAE;EAC7C,MAAM,cAAc,aAAa,MAAM;AAEvC,MAAI,MAAM,SAAS;AACjB,OAAI,mBACF,OAAM,IAAI,MACR,8BAA8B,mBAAmB,GAAG,MAAM,WAC3D;AAEH,wBAAqB,MAAM;;AAG7B,OAAK,MAAM,iBAAiB,MAAM,gBAAgB;GAChD,IAAI,iBAAiB,8BAA8B,IAAI,cAAc;AACrE,OAAI,mBAAmB,KAAA,GAAW;AAChC,qBAAiB,EAAE;AACnB,kCAA8B,IAAI,eAAe,eAAe;;AAElE,kBAAe,KAAK,MAAM,SAAS;;AAGrC,OAAK,MAAM,YAAY,YAAY,WAAW;GAC5C,MAAM,aAAa,SAAS,QAAQ,IAAI;GACxC,MAAM,aACJ,cAAc,IAAI,SAAS,MAAM,GAAG,WAAW,GAAG;AACpD,OAAI,CAAC,WAAY;GAEjB,MAAM,WAAW,qBAAqB,IAAI,WAAW;AACrD,wBAAqB,IACnB,YACA,WACI,MAAM,KAAK,IAAI,IAAI,CAAC,GAAG,UAAU,GAAG,MAAM,IAAI,CAAC,CAAC,GAChD,MAAM,IAAI,OAAO,CACtB;;;AAIL,MAAK,MAAM,YAAY,cAAc;AACnC,MAAI,CAAC,SAAS,SAAS,OAAO,CAC5B;EAGF,MAAM,cAAc,aAAa;AACjC,MAAI,YAAY,SAAS,QACvB;EAGF,MAAM,MAAM,kBAAkB,YAAY,OAAO;AACjD,MAAI,QAAQ,KAAA,EACV,sBAAqB,IAAI,UAAU,IAAI;;AAI3C,KAAI,CAAC,mBACH,OAAM,IAAI,MAAM,sBAAsB;AAGxC,QAAO;EACL;EACA;EACA;EACA;EACA;EACD;;AAGH,SAAgB,+BAA+B,WAA0B;CACvE,IAAI;CACJ,IAAI;AAEJ,MAAK,MAAM,YAAY,WAAW;EAChC,MAAM,aAAa,SAAS,QAAQ,IAAI;AAExC,MAAI,aAAa,EACf;EAGF,MAAM,QAAQ,SAAS,MAAM,aAAa,EAAE;AAE5C,MAAI,CAAC,MAAM,SAAS,SAAS,CAC3B;AAGF,MAAI,CAAC,IAAI,gBAAgB,MAAM,CAAC,IAAI,SAAS,CAC3C;EAGF,MAAM,gBAAgB,SAAS,MAAM,GAAG,WAAW;AAEnD,MAAI,oBAAoB,IAAI,cAAc,CACxC;AAGF,MAAI,mBAAmB,KAAA,KAAa,uBAAuB,KAAA,GAAW;AACpE,oBAAiB,EAAE;AACnB,wCAAqB,IAAI,KAAa;;AAGxC,iBAAe,KAAK,cAAc;AAClC,qBAAmB,IAAI,cAAc;;AAGvC,QAAO,kBAAkB,EAAE"}

package/dist/esm/vite/start-manifest-plugin/plugin.js

@@ -25,7 +25,7 @@ function startManifestPlugin(opts) {
 		moduleId: VIRTUAL_MODULES.startManifest,
 		enforce: "pre",
 		load() {
-			const { resolvedStartConfig } = opts.getConfig();
+			const { resolvedStartConfig, startConfig } = opts.getConfig();
 			const clientEntry = joinURL(resolvedStartConfig.basePaths.publicBase, "@id", ENTRY_POINTS.client);
 			if (this.environment.name !== START_ENVIRONMENT_NAMES.server) return getEmptyStartManifestModule(clientEntry);
 			if (this.environment.config.command === "serve") return getEmptyStartManifestModule(clientEntry);
@@ -35,6 +35,7 @@ function startManifestPlugin(opts) {
 				clientBuild,
 				routeTreeRoutes,
 				basePath: resolvedStartConfig.basePaths.publicBase,
+				inlineCss: startConfig.server.build.inlineCss,
 				additionalRouteAssets: getViteAdditionalRouteAssets({
 					cssCodeSplitDisabledFileName,
 					basePath: resolvedStartConfig.basePaths.publicBase,

package/dist/esm/vite/start-manifest-plugin/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","names":[],"sources":["../../../../src/vite/start-manifest-plugin/plugin.ts"],"sourcesContent":["import { joinURL } from 'ufo'\nimport { VIRTUAL_MODULES } from '@tanstack/start-server-core'\nimport { rootRouteId } from '@tanstack/router-core'\nimport { ENTRY_POINTS, START_ENVIRONMENT_NAMES } from '../../constants'\nimport {\n  buildStartManifest,\n  createManifestAssetResolvers,\n  normalizeViteClientBuild,\n  serializeStartManifest,\n} from '../../start-manifest-plugin/manifestBuilder'\nimport { createVirtualModule } from '../createVirtualModule'\nimport type { GetConfigFn, NormalizedClientBuild } from '../../types'\nimport type { PluginOption, Rollup } from 'vite'\n\nexport function startManifestPlugin(opts: {\n  getConfig: GetConfigFn\n}): PluginOption {\n  let clientBuild: NormalizedClientBuild | undefined\n  let cssCodeSplitDisabledFileName: string | undefined\n\n  return [\n    {\n      name: 'tanstack-start:start-manifest-capture-client-build',\n      applyToEnvironment(environment) {\n        return environment.name === START_ENVIRONMENT_NAMES.client\n      },\n      enforce: 'post',\n      generateBundle(_options, bundle) {\n        if (this.environment.name !== START_ENVIRONMENT_NAMES.client) {\n          throw new Error(\n            `Unexpected environment for client build capture: ${this.environment.name}`,\n          )\n        }\n\n        clientBuild = normalizeViteClientBuild(bundle)\n        cssCodeSplitDisabledFileName = getAssetFileNameByName(\n          bundle,\n          'style.css',\n        )\n      },\n    },\n    createVirtualModule({\n      name: 'tanstack-start:start-manifest-plugin',\n      moduleId: VIRTUAL_MODULES.startManifest,\n      enforce: 'pre',\n      load() {\n        const { resolvedStartConfig } = opts.getConfig()\n        const clientEntry = joinURL(\n          resolvedStartConfig.basePaths.publicBase,\n          '@id',\n          ENTRY_POINTS.client,\n        )\n\n        if (this.environment.name !== START_ENVIRONMENT_NAMES.server) {\n          return getEmptyStartManifestModule(clientEntry)\n        }\n\n        if (this.environment.config.command === 'serve') {\n          return getEmptyStartManifestModule(clientEntry)\n        }\n\n        const routeTreeRoutes = globalThis.TSS_ROUTES_MANIFEST\n        // TODO this needs further discussion with vite-rsc, this is a temporary workaround\n        // If the client bundle isn't available yet (e.g., during RSC scan builds),\n        // return a dummy manifest. The real manifest will be generated in the actual build.\n        if (!clientBuild) {\n          return getEmptyStartManifestModule(clientEntry)\n        }\n        const startManifest = buildStartManifest({\n          clientBuild,\n          routeTreeRoutes,\n          basePath: resolvedStartConfig.basePaths.publicBase,\n          additionalRouteAssets: getViteAdditionalRouteAssets({\n            cssCodeSplitDisabledFileName,\n            basePath: resolvedStartConfig.basePaths.publicBase,\n            cssCodeSplit: this.environment.config.build.cssCodeSplit,\n          }),\n        })\n\n        return `export const tsrStartManifest = () => (${serializeStartManifest(startManifest)})`\n      },\n    }),\n  ]\n}\n\nfunction getViteAdditionalRouteAssets(options: {\n  cssCodeSplitDisabledFileName: string | undefined\n  basePath: string\n  cssCodeSplit: boolean | undefined\n}) {\n  if (options.cssCodeSplit !== false) {\n    return undefined\n  }\n\n  if (!options.cssCodeSplitDisabledFileName) {\n    throw new Error(\n      \"TanStack Start could not find Vite's generated `style.css` manifest entry while `build.cssCodeSplit` is disabled\",\n    )\n  }\n\n  const { getStylesheetAsset } = createManifestAssetResolvers(options.basePath)\n\n  return {\n    [rootRouteId]: [getStylesheetAsset(options.cssCodeSplitDisabledFileName)],\n  }\n}\n\nfunction getAssetFileNameByName(\n  bundle: Rollup.OutputBundle,\n  assetName: string,\n) {\n  for (const fileName in bundle) {\n    const bundleEntry = bundle[fileName]!\n\n    if (bundleEntry.type !== 'asset') {\n      continue\n    }\n\n    if (bundleEntry.name === assetName) {\n      return fileName\n    }\n\n    if ('names' in bundleEntry && bundleEntry.names.includes(assetName)) {\n      return fileName\n    }\n  }\n\n  return undefined\n}\n\nfunction getEmptyStartManifestModule(clientEntry: string) {\n  return `export const tsrStartManifest = () => ({\n      routes: {},\n      clientEntry: '${clientEntry}',\n    })`\n}\n"],"mappings":";;;;;;;;AAcA,SAAgB,oBAAoB,MAEnB;CACf,IAAI;CACJ,IAAI;AAEJ,QAAO,CACL;EACE,MAAM;EACN,mBAAmB,aAAa;AAC9B,UAAO,YAAY,SAAS,wBAAwB;;EAEtD,SAAS;EACT,eAAe,UAAU,QAAQ;AAC/B,OAAI,KAAK,YAAY,SAAS,wBAAwB,OACpD,OAAM,IAAI,MACR,oDAAoD,KAAK,YAAY,OACtE;AAGH,iBAAc,yBAAyB,OAAO;AAC9C,kCAA+B,uBAC7B,QACA,YACD;;EAEJ,EACD,oBAAoB;EAClB,MAAM;EACN,UAAU,gBAAgB;EAC1B,SAAS;EACT,OAAO;GACL,MAAM,EAAE,wBAAwB,KAAK,WAAW;GAChD,MAAM,cAAc,QAClB,oBAAoB,UAAU,YAC9B,OACA,aAAa,OACd;AAED,OAAI,KAAK,YAAY,SAAS,wBAAwB,OACpD,QAAO,4BAA4B,YAAY;AAGjD,OAAI,KAAK,YAAY,OAAO,YAAY,QACtC,QAAO,4BAA4B,YAAY;GAGjD,MAAM,kBAAkB,WAAW;AAInC,OAAI,CAAC,YACH,QAAO,4BAA4B,YAAY;AAajD,UAAO,0CAA0C,uBAX3B,mBAAmB;IACvC;IACA;IACA,UAAU,oBAAoB,UAAU;IACxC,uBAAuB,6BAA6B;KAClD;KACA,UAAU,oBAAoB,UAAU;KACxC,cAAc,KAAK,YAAY,OAAO,MAAM;KAC7C,CAAC;IACH,CAAC,CAEoF,CAAC;;EAE1F,CAAC,CACH;;AAGH,SAAS,6BAA6B,SAInC;AACD,KAAI,QAAQ,iBAAiB,MAC3B;AAGF,KAAI,CAAC,QAAQ,6BACX,OAAM,IAAI,MACR,mHACD;CAGH,MAAM,EAAE,uBAAuB,6BAA6B,QAAQ,SAAS;AAE7E,QAAO,GACJ,cAAc,CAAC,mBAAmB,QAAQ,6BAA6B,CAAC,EAC1E;;AAGH,SAAS,uBACP,QACA,WACA;AACA,MAAK,MAAM,YAAY,QAAQ;EAC7B,MAAM,cAAc,OAAO;AAE3B,MAAI,YAAY,SAAS,QACvB;AAGF,MAAI,YAAY,SAAS,UACvB,QAAO;AAGT,MAAI,WAAW,eAAe,YAAY,MAAM,SAAS,UAAU,CACjE,QAAO;;;AAOb,SAAS,4BAA4B,aAAqB;AACxD,QAAO;;sBAEa,YAAY"}
+{"version":3,"file":"plugin.js","names":[],"sources":["../../../../src/vite/start-manifest-plugin/plugin.ts"],"sourcesContent":["import { joinURL } from 'ufo'\nimport { VIRTUAL_MODULES } from '@tanstack/start-server-core'\nimport { rootRouteId } from '@tanstack/router-core'\nimport { ENTRY_POINTS, START_ENVIRONMENT_NAMES } from '../../constants'\nimport {\n  buildStartManifest,\n  createManifestAssetResolvers,\n  normalizeViteClientBuild,\n  serializeStartManifest,\n} from '../../start-manifest-plugin/manifestBuilder'\nimport { createVirtualModule } from '../createVirtualModule'\nimport type { GetConfigFn, NormalizedClientBuild } from '../../types'\nimport type { PluginOption, Rollup } from 'vite'\n\nexport function startManifestPlugin(opts: {\n  getConfig: GetConfigFn\n}): PluginOption {\n  let clientBuild: NormalizedClientBuild | undefined\n  let cssCodeSplitDisabledFileName: string | undefined\n\n  return [\n    {\n      name: 'tanstack-start:start-manifest-capture-client-build',\n      applyToEnvironment(environment) {\n        return environment.name === START_ENVIRONMENT_NAMES.client\n      },\n      enforce: 'post',\n      generateBundle(_options, bundle) {\n        if (this.environment.name !== START_ENVIRONMENT_NAMES.client) {\n          throw new Error(\n            `Unexpected environment for client build capture: ${this.environment.name}`,\n          )\n        }\n\n        clientBuild = normalizeViteClientBuild(bundle)\n        cssCodeSplitDisabledFileName = getAssetFileNameByName(\n          bundle,\n          'style.css',\n        )\n      },\n    },\n    createVirtualModule({\n      name: 'tanstack-start:start-manifest-plugin',\n      moduleId: VIRTUAL_MODULES.startManifest,\n      enforce: 'pre',\n      load() {\n        const { resolvedStartConfig, startConfig } = opts.getConfig()\n        const clientEntry = joinURL(\n          resolvedStartConfig.basePaths.publicBase,\n          '@id',\n          ENTRY_POINTS.client,\n        )\n\n        if (this.environment.name !== START_ENVIRONMENT_NAMES.server) {\n          return getEmptyStartManifestModule(clientEntry)\n        }\n\n        if (this.environment.config.command === 'serve') {\n          return getEmptyStartManifestModule(clientEntry)\n        }\n\n        const routeTreeRoutes = globalThis.TSS_ROUTES_MANIFEST\n        // TODO this needs further discussion with vite-rsc, this is a temporary workaround\n        // If the client bundle isn't available yet (e.g., during RSC scan builds),\n        // return a dummy manifest. The real manifest will be generated in the actual build.\n        if (!clientBuild) {\n          return getEmptyStartManifestModule(clientEntry)\n        }\n        const startManifest = buildStartManifest({\n          clientBuild,\n          routeTreeRoutes,\n          basePath: resolvedStartConfig.basePaths.publicBase,\n          inlineCss: startConfig.server.build.inlineCss,\n          additionalRouteAssets: getViteAdditionalRouteAssets({\n            cssCodeSplitDisabledFileName,\n            basePath: resolvedStartConfig.basePaths.publicBase,\n            cssCodeSplit: this.environment.config.build.cssCodeSplit,\n          }),\n        })\n\n        return `export const tsrStartManifest = () => (${serializeStartManifest(startManifest)})`\n      },\n    }),\n  ]\n}\n\nfunction getViteAdditionalRouteAssets(options: {\n  cssCodeSplitDisabledFileName: string | undefined\n  basePath: string\n  cssCodeSplit: boolean | undefined\n}) {\n  if (options.cssCodeSplit !== false) {\n    return undefined\n  }\n\n  if (!options.cssCodeSplitDisabledFileName) {\n    throw new Error(\n      \"TanStack Start could not find Vite's generated `style.css` manifest entry while `build.cssCodeSplit` is disabled\",\n    )\n  }\n\n  const { getStylesheetAsset } = createManifestAssetResolvers(options.basePath)\n\n  return {\n    [rootRouteId]: [getStylesheetAsset(options.cssCodeSplitDisabledFileName)],\n  }\n}\n\nfunction getAssetFileNameByName(\n  bundle: Rollup.OutputBundle,\n  assetName: string,\n) {\n  for (const fileName in bundle) {\n    const bundleEntry = bundle[fileName]!\n\n    if (bundleEntry.type !== 'asset') {\n      continue\n    }\n\n    if (bundleEntry.name === assetName) {\n      return fileName\n    }\n\n    if ('names' in bundleEntry && bundleEntry.names.includes(assetName)) {\n      return fileName\n    }\n  }\n\n  return undefined\n}\n\nfunction getEmptyStartManifestModule(clientEntry: string) {\n  return `export const tsrStartManifest = () => ({\n      routes: {},\n      clientEntry: '${clientEntry}',\n    })`\n}\n"],"mappings":";;;;;;;;AAcA,SAAgB,oBAAoB,MAEnB;CACf,IAAI;CACJ,IAAI;AAEJ,QAAO,CACL;EACE,MAAM;EACN,mBAAmB,aAAa;AAC9B,UAAO,YAAY,SAAS,wBAAwB;;EAEtD,SAAS;EACT,eAAe,UAAU,QAAQ;AAC/B,OAAI,KAAK,YAAY,SAAS,wBAAwB,OACpD,OAAM,IAAI,MACR,oDAAoD,KAAK,YAAY,OACtE;AAGH,iBAAc,yBAAyB,OAAO;AAC9C,kCAA+B,uBAC7B,QACA,YACD;;EAEJ,EACD,oBAAoB;EAClB,MAAM;EACN,UAAU,gBAAgB;EAC1B,SAAS;EACT,OAAO;GACL,MAAM,EAAE,qBAAqB,gBAAgB,KAAK,WAAW;GAC7D,MAAM,cAAc,QAClB,oBAAoB,UAAU,YAC9B,OACA,aAAa,OACd;AAED,OAAI,KAAK,YAAY,SAAS,wBAAwB,OACpD,QAAO,4BAA4B,YAAY;AAGjD,OAAI,KAAK,YAAY,OAAO,YAAY,QACtC,QAAO,4BAA4B,YAAY;GAGjD,MAAM,kBAAkB,WAAW;AAInC,OAAI,CAAC,YACH,QAAO,4BAA4B,YAAY;AAcjD,UAAO,0CAA0C,uBAZ3B,mBAAmB;IACvC;IACA;IACA,UAAU,oBAAoB,UAAU;IACxC,WAAW,YAAY,OAAO,MAAM;IACpC,uBAAuB,6BAA6B;KAClD;KACA,UAAU,oBAAoB,UAAU;KACxC,cAAc,KAAK,YAAY,OAAO,MAAM;KAC7C,CAAC;IACH,CAAC,CAEoF,CAAC;;EAE1F,CAAC,CACH;;AAGH,SAAS,6BAA6B,SAInC;AACD,KAAI,QAAQ,iBAAiB,MAC3B;AAGF,KAAI,CAAC,QAAQ,6BACX,OAAM,IAAI,MACR,mHACD;CAGH,MAAM,EAAE,uBAAuB,6BAA6B,QAAQ,SAAS;AAE7E,QAAO,GACJ,cAAc,CAAC,mBAAmB,QAAQ,6BAA6B,CAAC,EAC1E;;AAGH,SAAS,uBACP,QACA,WACA;AACA,MAAK,MAAM,YAAY,QAAQ;EAC7B,MAAM,cAAc,OAAO;AAE3B,MAAI,YAAY,SAAS,QACvB;AAGF,MAAI,YAAY,SAAS,UACvB,QAAO;AAGT,MAAI,WAAW,eAAe,YAAY,MAAM,SAAS,UAAU,CACjE,QAAO;;;AAOb,SAAS,4BAA4B,aAAqB;AACxD,QAAO;;sBAEa,YAAY"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/start-plugin-core",
-  "version": "1.169.0",
+  "version": "1.169.2",
   "description": "Modern and scalable routing for React applications",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -76,6 +76,7 @@
     "seroval": "^1.5.0",
     "cheerio": "^1.0.0",
     "exsolve": "^1.0.7",
+    "lightningcss": "^1.32.0",
     "pathe": "^2.0.3",
     "picomatch": "^4.0.3",
     "srvx": "^0.11.9",
@@ -85,15 +86,15 @@
     "vitefu": "^1.1.1",
     "xmlbuilder2": "^4.0.3",
     "zod": "^3.24.2",
-    "@tanstack/router-core": "1.168.15",
-    "@tanstack/router-generator": "1.166.33",
-    "@tanstack/router-plugin": "1.167.23",
+    "@tanstack/router-core": "1.168.16",
+    "@tanstack/router-generator": "1.166.34",
+    "@tanstack/router-plugin": "1.167.24",
     "@tanstack/router-utils": "1.161.7",
-    "@tanstack/start-client-core": "1.167.17",
-    "@tanstack/start-server-core": "1.167.19"
+    "@tanstack/start-client-core": "1.167.18",
+    "@tanstack/start-server-core": "1.167.20"
   },
   "devDependencies": {
-    "@rsbuild/core": "^2.0.0",
+    "@rsbuild/core": "^2.0.1",
     "@types/babel__code-frame": "^7.0.6",
     "@types/babel__core": "^7.20.5",
     "@types/picomatch": "^4.0.2",

package/src/rsbuild/normalized-client-build.ts

@@ -1,4 +1,5 @@
 import { tsrSplit } from '@tanstack/router-plugin'
+import { getCssAssetSource } from '../start-manifest-plugin/inlineCss'
 import { RSBUILD_ENVIRONMENT_NAMES } from './planning'
 import type { RsbuildPluginAPI, Rspack } from '@rsbuild/core'
 import type { NormalizedClientBuild, NormalizedClientChunk } from '../types'
@@ -162,6 +163,7 @@ export function normalizeRspackClientBuild(
   const chunksByFileName = new Map<string, NormalizedClientChunk>()
   const chunkFileNamesByRouteFilePath = new Map<string, Array<string>>()
   const cssFilesBySourcePath = new Map<string, Array<string>>()
+  const cssContentByFileName = new Map<string, string>()
   let entryChunkFileName: string | undefined
 
   // Collect all initial JS file names from the main entry for computing
@@ -272,6 +274,17 @@ export function normalizeRspackClientBuild(
     throw new Error('No entry file found in rspack client build')
   }
 
+  for (const asset of compilation.getAssets()) {
+    if (!asset.name.endsWith('.css')) {
+      continue
+    }
+
+    const css = getCssAssetSource(asset.source.source())
+    if (css !== undefined) {
+      cssContentByFileName.set(asset.name, css)
+    }
+  }
+
   // In RSC mode, CSS from server components is associated with the 'rsc'
   // client entry chunk (not the main 'index' entry). The manifest builder
   // merges the entry chunk's CSS into __root__, so by appending RSC CSS
@@ -299,6 +312,7 @@ export function normalizeRspackClientBuild(
     chunksByFileName,
     chunkFileNamesByRouteFilePath,
     cssFilesBySourcePath,
+    cssContentByFileName,
   }
 }
 

package/src/rsbuild/plugin.ts

@@ -161,6 +161,7 @@ export function tanStackStartRsbuild(
           routerBasepath,
           serverFnBase: startConfig.serverFns.base,
         })
+        const inlineCssEnabled = !isDev && startConfig.server.build.inlineCss
 
         return mergeRsbuildConfig(rsbuildConfig, {
           source: {
@@ -188,6 +189,12 @@ export function tanStackStartRsbuild(
               'import.meta.env.TSS_DEV_SSR_STYLES_BASEPATH': JSON.stringify(
                 resolvedStartConfig.basePaths.publicBase,
               ),
+              'process.env.TSS_INLINE_CSS_ENABLED': JSON.stringify(
+                inlineCssEnabled ? 'true' : 'false',
+              ),
+              'import.meta.env.TSS_INLINE_CSS_ENABLED': JSON.stringify(
+                inlineCssEnabled ? 'true' : 'false',
+              ),
             },
           },
           server: {

package/src/rsbuild/virtual-modules.ts

@@ -76,33 +76,39 @@ export const tsrStartManifest = () => globalThis[${JSON.stringify(DEV_START_MANI
 function buildStartManifestData(
   clientBuild: NormalizedClientBuild,
   publicBase: string,
+  inlineCss: boolean,
 ) {
   const routeTreeRoutes = globalThis.TSS_ROUTES_MANIFEST
   return buildStartManifest({
     clientBuild,
     routeTreeRoutes,
     basePath: publicBase,
+    inlineCss,
   })
 }
 
 function serializeStartManifestData(
   clientBuild: NormalizedClientBuild,
   publicBase: string,
+  inlineCss: boolean,
 ): string {
-  return JSON.stringify(buildStartManifestData(clientBuild, publicBase))
+  return JSON.stringify(
+    buildStartManifestData(clientBuild, publicBase, inlineCss),
+  )
 }
 
 function generateManifestModuleBuild(
   clientBuild: NormalizedClientBuild | undefined,
   publicBase: string,
   _devClientEntryUrl: string,
+  inlineCss: boolean,
 ): string {
   if (!clientBuild) {
     return `const tsrStartManifestData = ${JSON.stringify(START_MANIFEST_PLACEHOLDER)}
 export const tsrStartManifest = () => tsrStartManifestData`
   }
 
-  return `export const tsrStartManifest = () => (${serializeStartManifestData(clientBuild, publicBase)})`
+  return `export const tsrStartManifest = () => (${serializeStartManifestData(clientBuild, publicBase, inlineCss)})`
 }
 
 // ---------------------------------------------------------------------------
@@ -345,7 +351,7 @@ export function registerVirtualModules(
   // Generate initial content for each virtual module per environment
   function getInitialContent(environmentName: string): Record<string, string> {
     // Safe to call getConfig() here — this runs inside modifyRspackConfig
-    const { resolvedStartConfig } = opts.getConfig()
+    const { resolvedStartConfig, startConfig } = opts.getConfig()
     const isServerEnv = environmentName === RSBUILD_ENVIRONMENT_NAMES.server
     const isClientEnv = environmentName === RSBUILD_ENVIRONMENT_NAMES.client
     const content: Record<string, string> = {}
@@ -361,6 +367,7 @@ export function registerVirtualModules(
             clientBuild,
             resolvedStartConfig.basePaths.publicBase,
             devClientEntryUrl,
+            startConfig.server.build.inlineCss,
           )
     } else {
       content[paths.manifest] = 'export default {}'
@@ -495,7 +502,7 @@ export function createFromReadableStream() { throw new Error('RSC SSR decode is
     },
 
     generateManifestContent(newClientBuild: NormalizedClientBuild): string {
-      const { resolvedStartConfig } = opts.getConfig()
+      const { resolvedStartConfig, startConfig } = opts.getConfig()
       const devClientEntryUrl = opts.getDevClientEntryUrl(
         resolvedStartConfig.basePaths.publicBase,
       )
@@ -503,16 +510,18 @@ export function createFromReadableStream() { throw new Error('RSC SSR decode is
         newClientBuild,
         resolvedStartConfig.basePaths.publicBase,
         devClientEntryUrl,
+        !isDev && startConfig.server.build.inlineCss,
       )
     },
 
     generateManifestValueLiteral(
       newClientBuild: NormalizedClientBuild,
     ): string {
-      const { resolvedStartConfig } = opts.getConfig()
+      const { resolvedStartConfig, startConfig } = opts.getConfig()
       return serializeStartManifestData(
         newClientBuild,
         resolvedStartConfig.basePaths.publicBase,
+        !isDev && startConfig.server.build.inlineCss,
       )
     },
 
@@ -528,6 +537,7 @@ export function createFromReadableStream() { throw new Error('RSC SSR decode is
         )[DEV_START_MANIFEST_GLOBAL] = buildStartManifestData(
           clientBuild,
           resolvedStartConfig.basePaths.publicBase,
+          false,
         )
       }
     },

package/src/schema.ts

@@ -209,6 +209,12 @@ export const tanstackStartOptionsObjectSchema = z.object({
       build: z
         .object({
           staticNodeEnv: z.boolean().optional().default(true),
+          /**
+           * Inline route CSS into the server-rendered HTML response.
+           *
+           * @experimental This option is experimental!
+           */
+          inlineCss: z.boolean().optional().default(false),
         })
         .optional()
         .default({}),

package/src/start-manifest-plugin/inlineCss.ts

@@ -0,0 +1,93 @@
+import { transform } from 'lightningcss'
+
+const cssUrlPattern =
+  /url\(\s*(?:"([^"]*)"|'([^']*)'|([^)"']*?))\s*\)|@import\s+(?:url\(\s*(?:"([^"]*)"|'([^']*)'|([^)"']*?))\s*\)|"([^"]*)"|'([^']*)')/gi
+
+function isRelativeCssUrl(url: string) {
+  if (!url) return false
+  if (url.startsWith('#')) return false
+  if (url.startsWith('/')) return false
+  if (/^[a-z][a-z\d+.-]*:/i.test(url)) return false
+  return true
+}
+
+export function shouldRebaseInlineCssUrls(css: string) {
+  cssUrlPattern.lastIndex = 0
+
+  for (const match of css.matchAll(cssUrlPattern)) {
+    const url = (
+      match[1] ??
+      match[2] ??
+      match[3] ??
+      match[4] ??
+      match[5] ??
+      match[6] ??
+      match[7] ??
+      match[8] ??
+      ''
+    ).trim()
+
+    if (isRelativeCssUrl(url)) {
+      return true
+    }
+  }
+
+  return false
+}
+
+function rebaseCssUrl(url: string, cssHref: string) {
+  if (!isRelativeCssUrl(url)) {
+    return url
+  }
+
+  const fakeOrigin = 'http://tanstack.local'
+  const resolved = new URL(url, new URL(cssHref, fakeOrigin))
+
+  if (resolved.origin === fakeOrigin) {
+    return `${resolved.pathname}${resolved.search}${resolved.hash}`
+  }
+
+  return resolved.href
+}
+
+export function rebaseInlineCssUrls(options: { css: string; cssHref: string }) {
+  const css = options.css.trim()
+
+  if (!shouldRebaseInlineCssUrls(css)) {
+    return css
+  }
+
+  const result = transform({
+    filename: options.cssHref,
+    code: Buffer.from(css),
+    minify: true,
+    visitor: {
+      Url(url) {
+        return {
+          ...url,
+          url: rebaseCssUrl(url.url, options.cssHref),
+        }
+      },
+      Rule: {
+        import(rule: any) {
+          return {
+            ...rule,
+            value: {
+              ...rule.value,
+              url: rebaseCssUrl(rule.value.url, options.cssHref),
+            },
+          }
+        },
+      },
+    },
+  })
+
+  return Buffer.from(result.code).toString('utf8')
+}
+
+export function getCssAssetSource(source: unknown) {
+  if (typeof source === 'string') return source
+  if (source instanceof Uint8Array) return Buffer.from(source).toString('utf8')
+  if (source == null) return undefined
+  return String(source)
+}

package/src/start-manifest-plugin/manifestBuilder.ts

@@ -1,12 +1,17 @@
 /* eslint-disable @typescript-eslint/prefer-for-of */
 import { serialize } from 'seroval'
 import { joinURL } from 'ufo'
-import { resolveManifestAssetLink, rootRouteId } from '@tanstack/router-core'
+import {
+  getStylesheetHref,
+  resolveManifestAssetLink,
+  rootRouteId,
+} from '@tanstack/router-core'
 import {
   getRouteFilePathsFromModuleIds,
   normalizeViteClientBuild,
   normalizeViteClientChunk,
 } from '../vite/start-manifest-plugin/normalized-client-build'
+import { rebaseInlineCssUrls } from './inlineCss'
 import type { ManifestAssetLink, RouterManagedTag } from '@tanstack/router-core'
 import type { NormalizedClientBuild, NormalizedClientChunk } from '../types'
 
@@ -42,6 +47,9 @@ type DedupeRoute = {
 export interface StartManifest {
   routes: Record<string, RouteTreeRoute>
   clientEntry: string
+  inlineCss?: {
+    styles: Record<string, string>
+  }
 }
 
 export function appendUniqueStrings(
@@ -152,6 +160,7 @@ export function buildStartManifest(options: {
   clientBuild: NormalizedClientBuild
   routeTreeRoutes: RouteTreeRoutes
   basePath: string
+  inlineCss?: boolean
   additionalRouteAssets?: Partial<
     Record<string, ReadonlyArray<RouterManagedTag>>
   >
@@ -180,10 +189,20 @@ export function buildStartManifest(options: {
     }
   }
 
-  return {
+  const result: StartManifest = {
     routes,
     clientEntry: assetResolvers.getAssetPath(scannedChunks.entryChunk.fileName),
   }
+
+  if (options.inlineCss) {
+    result.inlineCss = buildInlineCssManifestData({
+      routes,
+      basePath: options.basePath,
+      cssContentByFileName: options.clientBuild.cssContentByFileName,
+    })
+  }
+
+  return result
 }
 
 export function serializeStartManifest(startManifest: StartManifest) {
@@ -323,10 +342,6 @@ export function createChunkCssAssetCollector(options: {
     const assets: Array<RouterManagedTag> = []
     const seenAssets = new Set<RouterManagedTag>()
 
-    for (const cssFile of chunk.css) {
-      appendAsset(assets, seenAssets, options.getStylesheetAsset(cssFile))
-    }
-
     for (let i = 0; i < chunk.imports.length; i++) {
       const importedChunk = options.chunksByFileName.get(chunk.imports[i]!)
       if (!importedChunk) {
@@ -339,6 +354,10 @@ export function createChunkCssAssetCollector(options: {
       }
     }
 
+    for (const cssFile of chunk.css) {
+      appendAsset(assets, seenAssets, options.getStylesheetAsset(cssFile))
+    }
+
     stateByChunk.delete(chunk)
     assetsByChunk.set(chunk, assets)
     return assets
@@ -347,6 +366,57 @@ export function createChunkCssAssetCollector(options: {
   return { getChunkCssAssets }
 }
 
+function buildInlineCssManifestData(options: {
+  routes: Record<string, RouteTreeRoute>
+  basePath: string
+  cssContentByFileName: ReadonlyMap<string, string> | undefined
+}): StartManifest['inlineCss'] {
+  const stylesheetHrefs = new Set<string>()
+
+  for (const route of Object.values(options.routes)) {
+    for (const asset of route.assets ?? []) {
+      const href = getStylesheetHref(asset)
+      if (href) {
+        stylesheetHrefs.add(href)
+      }
+    }
+  }
+
+  if (stylesheetHrefs.size === 0) {
+    return { styles: {} }
+  }
+
+  if (!options.cssContentByFileName) {
+    throw new Error(
+      'TanStack Start inlineCss is enabled, but the client build did not provide CSS content',
+    )
+  }
+
+  const { getAssetPath } = createManifestAssetResolvers(options.basePath)
+  const styles: Record<string, string> = {}
+  const missingHrefs = new Set(stylesheetHrefs)
+
+  for (const [cssFile, css] of options.cssContentByFileName) {
+    const cssHref = getAssetPath(cssFile)
+    if (!stylesheetHrefs.has(cssHref)) {
+      continue
+    }
+
+    styles[cssHref] = rebaseInlineCssUrls({ css, cssHref })
+    missingHrefs.delete(cssHref)
+  }
+
+  if (missingHrefs.size > 0) {
+    throw new Error(
+      `TanStack Start inlineCss could not find CSS content for: ${Array.from(
+        missingHrefs,
+      ).join(', ')}`,
+    )
+  }
+
+  return { styles }
+}
+
 export function buildRouteManifestRoutes(options: {
   routeTreeRoutes: RouteTreeRoutes
   routeChunksByFilePath: ReadonlyMap<

package/src/types.ts

@@ -47,6 +47,7 @@ export interface NormalizedClientBuild {
   chunksByFileName: ReadonlyMap<string, NormalizedClientChunk>
   chunkFileNamesByRouteFilePath: ReadonlyMap<string, ReadonlyArray<string>>
   cssFilesBySourcePath: ReadonlyMap<string, ReadonlyArray<string>>
+  cssContentByFileName?: ReadonlyMap<string, string>
 }
 
 export interface TanStackStartCoreOptions {

package/src/vite/planning.ts

@@ -136,6 +136,7 @@ export function createViteDefineConfig(opts: {
   spaEnabled: boolean | undefined
   devSsrStylesEnabled: boolean
   devSsrStylesBasepath: string
+  inlineCssEnabled: boolean
   staticNodeEnv: boolean
 }) {
   return {
@@ -156,6 +157,10 @@ export function createViteDefineConfig(opts: {
       'TSS_DEV_SSR_STYLES_BASEPATH',
       opts.devSsrStylesBasepath,
     ),
+    ...defineReplaceEnv(
+      'TSS_INLINE_CSS_ENABLED',
+      opts.inlineCssEnabled ? 'true' : 'false',
+    ),
     ...(opts.command === 'build' && opts.staticNodeEnv
       ? {
           'process.env.NODE_ENV': JSON.stringify(

package/src/vite/plugin.ts

@@ -185,6 +185,8 @@ export function tanStackStartVite(
             devSsrStylesBasepath:
               startConfig.dev.ssrStyles.basepath ??
               resolvedStartConfig.basePaths.publicBase,
+            inlineCssEnabled:
+              command === 'build' && startConfig.server.build.inlineCss,
             staticNodeEnv: startConfig.server.build.staticNodeEnv,
           }),
           builder: {