QwikDev · thejackshelton-kunaico · Aug 4, 2025 · Aug 4, 2025 · Aug 4, 2025 · Aug 4, 2025
diff --git a/.changeset/green-jobs-jog.md b/.changeset/green-jobs-jog.md
@@ -0,0 +1,18 @@
+---
+"@qwikdev/astro": patch
+---
+
+feat: support global config for renderOpts
+
+You can now pass the `renderOpts` option to the `qwik` integration to set global render options for all Qwik components.
+
+For example, let's say we wanted to change the base URL for all Qwik build assets on every component used in an Astro file.
+
+```ts
+import { defineConfig } from "astro/config";
+import qwik from "@qwikdev/astro";
+
+export default defineConfig({
+  integrations: [qwik({ include: "**/qwik/*", renderOpts: { base: "my-cdn-url/build" } })]
+});
+```
diff --git a/apps/demo/src/pages/index.astro b/apps/demo/src/pages/index.astro
@@ -12,7 +12,7 @@ import { Counter as NativeCounter } from "@components/qwik/counter";
 	</head>
 	<body>
 		<div style={{ height: "1000px" }}>
-			<NativeCounter initial={2} renderOpts={{ base: "http://192.168.68.76:4321/build" }} />
+			<NativeCounter initial={2} />
 		</div>
 	</body>
 </html>
diff --git a/libs/qwikdev-astro/package.json b/libs/qwikdev-astro/package.json
@@ -61,6 +61,7 @@
   },
   "bugs": "https://github.com/thejackshelton/@qwikdev/astro/issues",
   "dependencies": {
+    "@inox-tools/aik-mod": "^0.11.0",
     "astro-integration-kit": "^0.18.0"
   },
   "devDependencies": {

diff --git a/libs/qwikdev-astro/server.ts b/libs/qwikdev-astro/server.ts
@@ -3,6 +3,7 @@ import { isDev } from "@builder.io/qwik/build";
 import type { QwikManifest } from "@builder.io/qwik/optimizer";
 import { type RenderToStreamOptions, renderToStream } from "@builder.io/qwik/server";
 import type { SSRResult } from "astro";
+import { renderOpts as globalRenderOpts } from "virtual:qwikdev-astro";
 
 const containerMap = new WeakMap<SSRResult, boolean>();
 
@@ -73,7 +74,7 @@ export async function renderToStaticMarkup(
     const isInitialContainer = !containerMap.has(this.result);
 
     const renderToStreamOpts: RenderToStreamOptions = {
-      ...(props.renderOpts ?? {}),
+      ...(props.renderOpts ?? globalRenderOpts ?? {}),
       containerAttributes: {
         style: "display: contents",
         ...(isDev && { "q-astro-marker": "" })

diff --git a/libs/qwikdev-astro/src/index.ts b/libs/qwikdev-astro/src/index.ts
@@ -6,11 +6,29 @@ import type {
   QwikVitePluginOptions,
   SymbolMapperFn
 } from "@builder.io/qwik/optimizer";
+import type { RenderOptions } from "@builder.io/qwik/server";
 import type { AstroConfig, AstroIntegration } from "astro";
-import { createResolver, defineIntegration, watchDirectory } from "astro-integration-kit";
+import { createResolver, defineIntegration, watchDirectory, withPlugins } from "astro-integration-kit";
 import { z } from "astro/zod";
 import { type PluginOption, build, createFilter } from "vite";
 import type { InlineConfig } from "vite";
+import aikMod from '@inox-tools/aik-mod';
+
+// TODO: contributing this back to aik-mod where we export the type
+type DefineModuleOptions = {
+  constExports?: Record<string, unknown>;
+  defaultExport?: unknown;
+};
+
+type SetupPropsWithAikMod = 
+  Parameters<
+    NonNullable<AstroIntegration["hooks"]["astro:config:setup"]>
+  >[0] & {
+    defineModule: (
+      name: string,
+      options: DefineModuleOptions
+    ) => string;
+  };
 
 declare global {
   var symbolMapperFn: SymbolMapperFn;
@@ -26,12 +44,14 @@ const FilterPatternSchema = z.union([
   z.null()
 ]);
 
+const name = "@qwikdev/astro";
+
 /**
  * This project uses Astro Integration Kit.
  * @see https://astro-integration-kit.netlify.app/
  */
 export default defineIntegration({
-  name: "@qwikdev/astro",
+  name,
   optionsSchema: z
     .object({
       /**
@@ -48,11 +68,12 @@ export default defineIntegration({
        * Enable debug mode with the qwikVite plugin.
        */
       debug: z.boolean().optional(),
-
       /**
-       * Use node's readFileSync to read the manifest. Common for deployment providers that don't support dynamic json imports. When false, please ensure your deployment provider supports dynamic json imports, through environment variables or other means.
+       * Options passed into each Qwik component's `renderToStream` call. 
        */
-      isNode: z.boolean().optional().default(true)
+      renderOpts: z.custom<RenderOptions>((data) => {
+        return typeof data === "object" && data !== null;
+      }).optional()
     })
     .optional(),
 
@@ -77,7 +98,7 @@ export default defineIntegration({
 
     const lifecycleHooks: AstroIntegration["hooks"] = {
       "astro:config:setup": async (setupProps) => {
-        const { addRenderer, updateConfig, config } = setupProps;
+        const { addRenderer, updateConfig, config, defineModule } = setupProps as SetupPropsWithAikMod;
         astroConfig = config;
         // integration HMR support
         watchDirectory(setupProps, resolver());
@@ -86,6 +107,12 @@ export default defineIntegration({
           serverEntrypoint: resolver("../server.ts")
         });
 
+        defineModule('virtual:qwikdev-astro', {
+          constExports: {
+            renderOpts: options?.renderOpts ?? {}
+          }
+        });
+
         /** Relative paths, as the Qwik optimizer handles normalization */
         srcDir = getRelativePath(astroConfig.root.pathname, astroConfig.srcDir.pathname);
 
@@ -319,12 +346,14 @@ export default defineIntegration({
       }
     };
 
-    return {
-      hooks: lifecycleHooks
-    };
+    return withPlugins({
+      name,
+      hooks: lifecycleHooks,
+      plugins: [aikMod]
+    });
   }
 });
 
 function getRelativePath(from: string, to: string) {
   return to.replace(from, "") || ".";
-}
+}
diff --git a/libs/qwikdev-astro/src/virtual.d.ts b/libs/qwikdev-astro/src/virtual.d.ts
@@ -1,4 +1,6 @@
-declare module "inox:inline-mod:mod_0" {
-  export const isNode: boolean;
-  export const qAstroManifestPath: string;
+declare module "virtual:qwikdev-astro" {
+  import type { RenderOptions } from "@builder.io/qwik/server";
+
+  const renderOpts: RenderOptions;
+  export { renderOpts };
 }
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml