diff --git a/Island.cfm b/Island.cfm
index 93c3216..c640890 100644
--- a/Island.cfm
+++ b/Island.cfm
@@ -49,7 +49,10 @@ function resolveAsset(required string path) {
     if (cfg.isDev) {
         // Strip leading "./" so we get a clean URL join
         var clean = reReplace(arguments.path, "^\./", "");
-        return "http://localhost:#cfg.vitePort#/#clean#";
+        // viteUrl override (from COLDSPA_VITE_URL env) lets the browser reach
+        // a Vite dev server that isn't on localhost (e.g. host.docker.internal).
+        var viteBase = cfg.viteUrl ?: ("http://localhost:" & cfg.vitePort);
+        return viteBase & "/" & clean;
     }
 
     // Production: look up content-hashed file in vite manifest
@@ -97,10 +100,37 @@ if (isSimpleValue(rendered)) {
 }
 bootImports = rendered.imports;
 bootBody    = rendered.body;
+
+// Server-side rendering. If the renderer supports ssrRender(), call the SSR
+// sidecar and embed the returned HTML inside the mount div. The client's
+// createSSRApp().mount() will hydrate it on load. If SSR fails or isn't
+// available, we just emit an empty div and the client mounts fresh -- so the
+// page works either way (just no JS-off rendering in that case).
+ssrHtml  = "";
+ssrError = "";
+if (structKeyExists(attributes.framework, "ssrRender")) {
+    ssrResult = attributes.framework.ssrRender(componentGlobKey, attributes.props);
+    // Tolerate older renderers that returned a plain string.
+    if (isStruct(ssrResult)) {
+        ssrHtml  = ssrResult.html  ?: "";
+        ssrError = ssrResult.error ?: "";
+    } else {
+        ssrHtml = ssrResult;
+    }
+}
 </cfscript>
 
-<!--- Mount point --->
-<div id="<cfoutput>#mountId#</cfoutput>" data-coldspa-island="<cfoutput>#attributes.framework.name#</cfoutput>"></div>
+<!--- Surface SSR failures so they aren't silently swallowed. --->
+<cfif len(ssrError)>
+    <cfoutput><!-- coldspa SSR error: #encodeForHTML(ssrError)# --></cfoutput>
+<cfelseif not len(ssrHtml)>
+    <cfoutput><!-- coldspa SSR: empty html, no error reported (renderer may not implement ssrRender) --></cfoutput>
+<cfelse>
+    <cfoutput><!-- coldspa SSR: ok (#len(ssrHtml)# bytes) --></cfoutput>
+</cfif>
+
+<!--- Mount point (contains SSR HTML if available, for hydration) --->
+<div id="<cfoutput>#mountId#</cfoutput>" data-coldspa-island="<cfoutput>#attributes.framework.name#</cfoutput>"><cfoutput>#ssrHtml#</cfoutput></div>
 
 <cfoutput>
 <cfswitch expression="#attributes.strategy#">
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a5ba989
--- /dev/null
+++ b/README.md
@@ -0,0 +1,99 @@
+# Coldspa
+
+Astro-style framework islands for ColdFusion. Mount Vue (and React, soon) components into CFML pages with server-side rendering and progressive hydration.
+
+```cfml
+<cfinclude template="/coldspa/renderers/Vue.cfm">
+
+<cf_Island
+    framework="#Vue#"
+    path="./src/App.vue"
+    props="#{ hello: 'World' }#"
+    strategy="visible">
+</cf_Island>
+```
+
+## Quick start
+
+```bash
+npm install
+npm run dev      # Vite dev server (HMR)
+npm run ssr      # Node SSR sidecar
+```
+
+For production:
+
+```bash
+npm run build      # builds client + SSR bundles
+npm run ssr:prod   # runs the sidecar against the built bundle
+```
+
+## Configuration
+
+Coldspa resolves config in this order (highest priority first):
+
+1. **Environment variables** — for CI/CD, Docker, prod
+2. **`island-config.json`** in the webroot — for local dev / Admin UI
+3. **Built-in defaults**
+
+### Environment variables
+
+| Variable            | Effect                                                                   |
+|---------------------|--------------------------------------------------------------------------|
+| `CF_ENV`            | `development` / `dev` switches Coldspa to dev mode                       |
+| `COLDSPA_SSR_URL`   | Where **CF** reaches the SSR sidecar (server-to-server)                  |
+| `COLDSPA_VITE_URL`  | Where the **browser** reaches the Vite dev server (used for asset URLs)  |
+| `COLDSPA_SSR_PORT`  | (sidecar) Port to listen on. Default `5174`                              |
+| `COLDSPA_SSR_HOST`  | (sidecar) Bind address. Default `0.0.0.0`. Use `127.0.0.1` to lock down  |
+| `NODE_ENV`          | (sidecar) `production` switches sidecar to use built bundle              |
+
+### `island-config.json`
+
+Lives in the webroot. Should be `.gitignore`d (it can be edited via the CF Admin UI). Any keys you set here are merged on top of defaults but overridden by env vars.
+
+```json
+{
+    "isDev": true,
+    "ssrUrl":  "http://127.0.0.1:5174",
+    "viteUrl": "http://localhost:5173",
+    "vitePort": "5173"
+}
+```
+
+| Key        | Default                  | Description                                                 |
+|------------|--------------------------|-------------------------------------------------------------|
+| `isDev`    | `false`                  | Dev mode (uses Vite dev server) vs prod (uses `dist/`)      |
+| `ssrUrl`   | `http://127.0.0.1:5174`  | SSR sidecar URL (server-to-server)                          |
+| `viteUrl`  | unset                    | Browser-facing Vite URL. Falls back to `localhost:vitePort` |
+| `vitePort` | `"5173"`                 | Used to build the default `viteUrl` if `viteUrl` is unset   |
+
+After editing `island-config.json`, request any page with `?reloadApp=1` to bust the cached config (or restart CF).
+
+### Docker / cross-host setups
+
+Two URLs need to work from **different perspectives**:
+
+- `ssrUrl` — CF → Node sidecar (server-to-server). Set this on the CF container.
+- `viteUrl` — Browser → Vite dev server. Set this so generated `<script src="...">` URLs are reachable from the user's browser.
+
+Common patterns:
+
+| Setup                                        | `ssrUrl`                            | `viteUrl`                          |
+|----------------------------------------------|-------------------------------------|------------------------------------|
+| All on one host                              | `http://127.0.0.1:5174`             | _(unset — defaults to localhost)_  |
+| CF in Docker, Node on host (Win/Mac)         | `http://host.docker.internal:5174`  | `http://host.docker.internal:5173` |
+| CF in Docker, Node on host (Linux)           | `http://host.docker.internal:5174` ¹ | `http://host.docker.internal:5173` ¹ |
+| Both in docker-compose (sidecar service `coldspa-ssr`) | `http://coldspa-ssr:5174` | `http://localhost:5173` ²          |
+
+¹ On Linux, add `--add-host=host.docker.internal:host-gateway` to the CF container.
+² The browser still hits `localhost` because Vite's port is published from the compose stack to the host.
+
+### Vite dev server host binding
+
+When `viteUrl` (or `COLDSPA_VITE_URL`) points at a non-localhost host, the Coldspa Vite plugin automatically:
+
+- binds the dev server to all interfaces (`server.host: true`)
+- adds the discovered hostname to `server.allowedHosts` so Vite 5.4+ doesn't reject the request with `403 Forbidden`
+- sets `server.origin` and `server.hmr.host` so generated asset / HMR URLs use the external hostname
+
+No extra Vite config is required — just set the URL.
diff --git a/coldspa/IslandConfig.cfc b/coldspa/IslandConfig.cfc
index 0c86d3b..7502acc 100644
--- a/coldspa/IslandConfig.cfc
+++ b/coldspa/IslandConfig.cfc
@@ -27,7 +27,7 @@
     <!--- ===== private ===== --->
 
     <cffunction name="resolve" access="private" returntype="struct" output="false">
-        <cfset var defaults = { "isDev": false, "vitePort": "5173" }>
+        <cfset var defaults = { "isDev": false, "vitePort": "5173", "ssrUrl": "http://127.0.0.1:5174" }>
         <cfset var resolved = duplicate(defaults)>
 
         <!--- 2nd priority: /island-config.json --->
@@ -45,14 +45,37 @@
             </cftry>
         </cfif>
 
-        <!--- 1st priority: CF_ENV environment variable --->
-        <cfset var envName = "">
+        <!--- 1st priority: environment variables (CI/CD, Docker) --->
+        <cfset var envSys = "">
         <cftry>
-            <cfset envName = createObject("java", "java.lang.System").getenv("CF_ENV") ?: "">
-            <cfcatch type="any"><cfset envName = ""></cfcatch>
+            <cfset envSys = createObject("java", "java.lang.System")>
+            <cfcatch type="any"></cfcatch>
         </cftry>
-        <cfif len(envName)>
-            <cfset resolved.isDev = (lcase(envName) eq "development" or lcase(envName) eq "dev")>
+
+        <cfif isObject(envSys)>
+            <cfset var envName = envSys.getenv("CF_ENV") ?: "">
+            <cfif len(envName)>
+                <cfset resolved.isDev = (lcase(envName) eq "development" or lcase(envName) eq "dev")>
+            </cfif>
+
+            <!--- COLDSPA_SSR_URL: where CF reaches the SSR sidecar.
+                  Common values:
+                    http://127.0.0.1:5174        -- CF and Node on same host
+                    http://host.docker.internal:5174  -- CF in Docker, Node on Docker host
+                    http://coldspa-ssr:5174      -- CF and Node both in compose, sidecar service name
+                    https://ssr.internal.example -- separate prod box / pod --->
+            <cfset var envSsrUrl = envSys.getenv("COLDSPA_SSR_URL") ?: "">
+            <cfif len(envSsrUrl)>
+                <cfset resolved.ssrUrl = envSsrUrl>
+            </cfif>
+
+            <!--- COLDSPA_VITE_URL: where the BROWSER reaches Vite in dev.
+                  This is what gets prefixed onto component URLs. Same Docker
+                  caveats apply but from the browser's perspective. --->
+            <cfset var envViteUrl = envSys.getenv("COLDSPA_VITE_URL") ?: "">
+            <cfif len(envViteUrl)>
+                <cfset resolved.viteUrl = envViteUrl>
+            </cfif>
         </cfif>
 
         <cfreturn resolved>
diff --git a/coldspa/renderers/Vue.cfm b/coldspa/renderers/Vue.cfm
index c76f73d..f0ec053 100644
--- a/coldspa/renderers/Vue.cfm
+++ b/coldspa/renderers/Vue.cfm
@@ -6,6 +6,37 @@
 Vue = {
     "name": "Vue",
     "clientEntry": "./coldspa/vite/clients/vue-client.js",
+
+    /**
+     * Server-renders the component to HTML by calling the SSR sidecar.
+     * Returns { html: string, error: string } so Island.cfm can surface
+     * diagnostic info in dev mode.
+     */
+    "ssrRender": function(componentGlobKey, props) {
+        var ssrUrl = (application.islandConfig.ssrUrl ?: "http://127.0.0.1:5174")
+                     & "/render/vue";
+        var payload = serializeJSON({
+            "componentPath": arguments.componentGlobKey,
+            "props": arguments.props
+        });
+        try {
+            cfhttp(url=ssrUrl, method="POST", timeout=5, result="local.resp") {
+                cfhttpparam(type="header", name="content-type", value="application/json");
+                cfhttpparam(type="body", value=payload);
+            }
+            if (find("200", local.resp.statusCode)) {
+                var parsed = deserializeJSON(local.resp.fileContent);
+                return { "html": parsed.html ?: "", "error": "" };
+            }
+            return {
+                "html": "",
+                "error": "SSR sidecar returned " & local.resp.statusCode & ": " & left(local.resp.fileContent, 500)
+            };
+        } catch (any e) {
+            return { "html": "", "error": "SSR call failed: " & e.message };
+        }
+    },
+
     "render": function(mountId, componentGlobKey, propsJson, resolvedClientEntry) {
         var jsId = arguments.mountId.replace('-', '_', 'all');
         return {
diff --git a/coldspa/vite/clients/vue-client.js b/coldspa/vite/clients/vue-client.js
index 6416877..432e93a 100644
--- a/coldspa/vite/clients/vue-client.js
+++ b/coldspa/vite/clients/vue-client.js
@@ -1,6 +1,9 @@
 // Coldspa Vue client entry. Bundled by Vite via the coldspa plugin.
 // __COLDSPA_GLOB__ is replaced at build time by the plugin's transform hook.
-import { createApp } from 'vue';
+//
+// Uses createSSRApp so .mount(el) HYDRATES if `el` already contains
+// server-rendered HTML, or mounts fresh if the SSR sidecar wasn't available.
+import { createSSRApp } from 'vue';
 
 const components = import.meta.glob('__COLDSPA_GLOB__');
 
@@ -15,5 +18,5 @@ export async function mount(componentPath, el, props) {
         return;
     }
     const mod = await loader();
-    createApp(mod.default, props).mount(el);
+    createSSRApp(mod.default, props).mount(el);
 }
diff --git a/coldspa/vite/clients/vue-ssr.js b/coldspa/vite/clients/vue-ssr.js
new file mode 100644
index 0000000..225b385
--- /dev/null
+++ b/coldspa/vite/clients/vue-ssr.js
@@ -0,0 +1,16 @@
+// Coldspa Vue SSR entry. Bundled by Vite with build.ssr=true via the coldspa plugin.
+// __COLDSPA_GLOB__ is replaced at build time.
+import { createSSRApp } from 'vue';
+import { renderToString } from 'vue/server-renderer';
+
+const components = import.meta.glob('__COLDSPA_GLOB__');
+
+export async function render(componentPath, props) {
+    const loader = components[componentPath];
+    if (!loader) {
+        throw new Error(`[Coldspa SSR] No Vue component registered for path "${componentPath}".`);
+    }
+    const mod = await loader();
+    const app = createSSRApp(mod.default, props);
+    return await renderToString(app);
+}
diff --git a/coldspa/vite/plugin.js b/coldspa/vite/plugin.js
index 9599561..a7a8c90 100644
--- a/coldspa/vite/plugin.js
+++ b/coldspa/vite/plugin.js
@@ -28,6 +28,7 @@
 
 import { fileURLToPath } from 'url';
 import { dirname, resolve } from 'path';
+import { existsSync, readFileSync } from 'fs';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
@@ -40,6 +41,11 @@ const FRAMEWORK_CLIENTS = {
     react: toViteId(resolve(__dirname, 'clients/react-client.js'))
 };
 
+// SSR entries (only Vue is implemented today; React SSR is a TODO).
+const FRAMEWORK_SSR = {
+    vue: toViteId(resolve(__dirname, 'clients/vue-ssr.js'))
+};
+
 const DEFAULT_GLOBS = {
     vue:   '/src/**/*.vue',
     react: '/src/**/*.{jsx,tsx}'
@@ -72,6 +78,73 @@ function renderGlobLiteral(glob) {
     return JSON.stringify(glob);
 }
 
+// Discover the externally-reachable Vite host so we can auto-expose the dev
+// server when CF / the browser hit it via something other than localhost
+// (e.g. host.docker.internal in a containerized CF setup).
+//
+// Sources, highest priority first:
+//   1. COLDSPA_VITE_URL env var
+//   2. island-config.json -> viteUrl
+//
+// Returns { hostname, needsExternal } or null if only localhost is in use.
+function discoverExternalHost(projectRoot) {
+    const sources = [];
+    if (process.env.COLDSPA_VITE_URL) {
+        sources.push(process.env.COLDSPA_VITE_URL);
+    }
+    const cfgPath = resolve(projectRoot, 'island-config.json');
+    if (existsSync(cfgPath)) {
+        try {
+            const cfg = JSON.parse(readFileSync(cfgPath, 'utf8'));
+            if (cfg && typeof cfg.viteUrl === 'string') sources.push(cfg.viteUrl);
+        } catch {
+            // Malformed JSON -- ignore and fall through.
+        }
+    }
+
+    for (const src of sources) {
+        try {
+            const url = new URL(src);
+            const host = url.hostname;
+            if (host && host !== 'localhost' && host !== '127.0.0.1' && host !== '::1') {
+                return { hostname: host, needsExternal: true };
+            }
+        } catch {
+            // Invalid URL -- skip.
+        }
+    }
+    return null;
+}
+
+// Build the Vite `server` config block, opening up host binding + the host
+// allowlist when an external host is detected.
+function serverConfig(vitePort, projectRoot) {
+    const external = discoverExternalHost(projectRoot);
+    const base = {
+        port: vitePort,
+        cors: true,
+        origin: `http://localhost:${vitePort}`
+    };
+    if (!external) return base;
+
+    return {
+        ...base,
+        // Bind on all interfaces so requests from other hosts (e.g. a CF
+        // container reaching the host's Vite via host.docker.internal) work.
+        host: true,
+        // Vite >=5.4 enforces a host header allowlist. Permit the discovered
+        // hostname so cross-host requests aren't rejected with 403.
+        allowedHosts: [external.hostname],
+        // Match origin so generated asset URLs (HMR, etc.) point at the right
+        // host instead of localhost.
+        origin: `http://${external.hostname}:${vitePort}`,
+        hmr: {
+            host: external.hostname,
+            clientPort: vitePort
+        }
+    };
+}
+
 export default function coldspa(options = {}) {
     const frameworks = options.frameworks ?? ['vue'];
     const vitePort   = options.vitePort   ?? 5173;
@@ -89,12 +162,24 @@ export default function coldspa(options = {}) {
     // for fast lookup in the transform hook.
     const globsByClientPath = {};
     const input = {};
+    const ssrInput = {};
     for (const fw of frameworks) {
         const clientPath = FRAMEWORK_CLIENTS[fw];
         input[`${fw}-client`] = clientPath;
         globsByClientPath[clientPath] = userGlobs[fw] ?? DEFAULT_GLOBS[fw];
+
+        // SSR entry (if framework supports it). Same glob applies.
+        if (FRAMEWORK_SSR[fw]) {
+            const ssrPath = FRAMEWORK_SSR[fw];
+            ssrInput[`${fw}-ssr`] = ssrPath;
+            globsByClientPath[ssrPath] = userGlobs[fw] ?? DEFAULT_GLOBS[fw];
+        }
     }
 
+    // Detect SSR build mode. Runs `vite build` with build.ssr=true and emits
+    // unhashed flat files into dist-ssr/ so the Node sidecar can require them.
+    const isSsrBuild = process.env.COLDSPA_SSR === '1';
+
     const subPluginsPromise = Promise.all(frameworks.map(loadFrameworkPlugin));
 
     return [
@@ -103,12 +188,41 @@ export default function coldspa(options = {}) {
             name: 'coldspa',
 
             config(_userConfig, { command }) {
+                if (isSsrBuild) {
+                    return {
+                        // SSR builds don't need a public base path; output is
+                        // consumed by Node, not the browser.
+                        build: {
+                            ssr: true,
+                            outDir: `${outDir}-ssr`,
+                            emptyOutDir: true,
+                            rollupOptions: {
+                                preserveEntrySignatures: 'strict',
+                                input: ssrInput,
+                                // Flat, unhashed names so the sidecar can
+                                // import a stable path like ./vue-ssr.js.
+                                output: {
+                                    entryFileNames: '[name].js',
+                                    chunkFileNames: '[name].js',
+                                    assetFileNames: '[name][extname]'
+                                }
+                            }
+                        }
+                    };
+                }
                 return {
                     base: command === 'build' ? baseProd : '/',
-                    server: {
-                        port: vitePort,
-                        cors: true,
-                        origin: `http://localhost:${vitePort}`
+                    server: serverConfig(vitePort, _userConfig.root || process.cwd()),
+                    // Exclude our client entries from Vite's dep pre-scan.
+                    // The scanner runs an esbuild pass that doesn't go through
+                    // our transform hook, so it sees the raw __COLDSPA_GLOB__
+                    // placeholder and bails. These files are entry points
+                    // anyway -- they don't belong in the optimized deps cache.
+                    optimizeDeps: {
+                        entries: [],
+                        exclude: Object.values(FRAMEWORK_CLIENTS).concat(
+                            Object.values(FRAMEWORK_SSR)
+                        )
                     },
                     build: {
                         manifest: true,
diff --git a/coldspa/vite/ssr-server.js b/coldspa/vite/ssr-server.js
new file mode 100644
index 0000000..ef02ab5
--- /dev/null
+++ b/coldspa/vite/ssr-server.js
@@ -0,0 +1,112 @@
+// Coldspa SSR sidecar.
+//
+// CFML calls this over HTTP to render component HTML before sending the page.
+//
+// Endpoints:
+//   POST /render/:framework
+//     body: { componentPath: string, props: object }
+//     200:  { html: string }
+//     500:  { error: string }
+//
+// Modes:
+//   - dev   (default if NODE_ENV !== 'production'): uses Vite's middleware-mode
+//           dev server + ssrLoadModule. Picks up component changes without
+//           rebuilding.
+//   - prod: imports the built bundle from dist-ssr/ directly. Run
+//           `npm run build:ssr` first.
+//
+// Env:
+//   COLDSPA_SSR_PORT   default 5174
+//   COLDSPA_SSR_HOST   default 0.0.0.0  (bind on all interfaces so CF running
+//                                        in a container or on another machine
+//                                        can reach the sidecar; restrict to
+//                                        '127.0.0.1' for single-host dev)
+//   NODE_ENV           'production' switches to prod mode
+
+import { createServer as createHttpServer } from 'http';
+import { fileURLToPath, pathToFileURL } from 'url';
+import { dirname, resolve } from 'path';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PROJECT_ROOT = resolve(__dirname, '..', '..'); // webroot
+const PORT = Number(process.env.COLDSPA_SSR_PORT || 5174);
+const HOST = process.env.COLDSPA_SSR_HOST || '0.0.0.0';
+const IS_PROD = process.env.NODE_ENV === 'production';
+
+// Map :framework path segment -> SSR module entry path / id
+const SSR_ENTRIES_DEV = {
+    vue: '/coldspa/vite/clients/vue-ssr.js'
+};
+const SSR_ENTRIES_PROD = {
+    vue: resolve(PROJECT_ROOT, 'dist-ssr', 'vue-ssr.js')
+};
+
+// --- module loading -----------------------------------------------------
+
+let viteDevServer = null;     // dev only
+const prodModuleCache = {};   // prod only
+
+async function getRenderer(framework) {
+    if (IS_PROD) {
+        if (prodModuleCache[framework]) return prodModuleCache[framework];
+        const path = SSR_ENTRIES_PROD[framework];
+        if (!path) throw new Error(`Unknown framework "${framework}"`);
+        // pathToFileURL so dynamic import works on Windows.
+        const mod = await import(pathToFileURL(path).href);
+        prodModuleCache[framework] = mod;
+        return mod;
+    }
+    // Dev: lazy-init Vite middleware-mode server, ssrLoadModule per request.
+    if (!viteDevServer) {
+        const { createServer } = await import('vite');
+        viteDevServer = await createServer({
+            root: PROJECT_ROOT,
+            server: { middlewareMode: true },
+            appType: 'custom'
+        });
+    }
+    const id = SSR_ENTRIES_DEV[framework];
+    if (!id) throw new Error(`Unknown framework "${framework}"`);
+    return await viteDevServer.ssrLoadModule(id);
+}
+
+// --- http ---------------------------------------------------------------
+
+async function readJsonBody(req) {
+    let body = '';
+    for await (const chunk of req) body += chunk;
+    return body ? JSON.parse(body) : {};
+}
+
+const server = createHttpServer(async (req, res) => {
+    if (req.method !== 'POST') {
+        res.statusCode = 405;
+        res.end();
+        return;
+    }
+    const m = req.url.match(/^\/render\/([a-z]+)$/);
+    if (!m) {
+        res.statusCode = 404;
+        res.end();
+        return;
+    }
+    const framework = m[1];
+
+    try {
+        const { componentPath, props } = await readJsonBody(req);
+        const renderer = await getRenderer(framework);
+        const html = await renderer.render(componentPath, props ?? {});
+        res.setHeader('content-type', 'application/json');
+        res.end(JSON.stringify({ html }));
+    } catch (err) {
+        // Log full stack server-side; send a short message to CF.
+        console.error('[coldspa-ssr]', err);
+        res.statusCode = 500;
+        res.setHeader('content-type', 'application/json');
+        res.end(JSON.stringify({ error: String(err?.message || err) }));
+    }
+});
+
+server.listen(PORT, HOST, () => {
+    console.log(`[coldspa-ssr] listening on http://${HOST}:${PORT} (${IS_PROD ? 'prod' : 'dev'})`);
+});
diff --git a/dist-ssr/App.js b/dist-ssr/App.js
new file mode 100644
index 0000000..543393e
--- /dev/null
+++ b/dist-ssr/App.js
@@ -0,0 +1,33 @@
+import { ref, mergeProps, useSSRContext } from "vue";
+import { ssrRenderAttrs, ssrInterpolate } from "vue/server-renderer";
+const _export_sfc = (sfc, props) => {
+  const target = sfc.__vccOpts || sfc;
+  for (const [key, val] of props) {
+    target[key] = val;
+  }
+  return target;
+};
+const _sfc_main = {
+  __name: "App",
+  __ssrInlineRender: true,
+  props: {
+    hello: { type: String, default: "" },
+    serverTime: { type: String, default: "" }
+  },
+  setup(__props) {
+    const count = ref(0);
+    return (_ctx, _push, _parent, _attrs) => {
+      _push(`<div${ssrRenderAttrs(mergeProps({ class: "island" }, _attrs))} data-v-f4406005><h2 data-v-f4406005>Hello, ${ssrInterpolate(__props.hello)}!</h2><p data-v-f4406005>Rendered server-side at: <code data-v-f4406005>${ssrInterpolate(__props.serverTime)}</code></p><p data-v-f4406005>Hydrated client-side by Vue.</p><button data-v-f4406005>${ssrInterpolate(count.value)}</button></div>`);
+    };
+  }
+};
+const _sfc_setup = _sfc_main.setup;
+_sfc_main.setup = (props, ctx) => {
+  const ssrContext = useSSRContext();
+  (ssrContext.modules || (ssrContext.modules = /* @__PURE__ */ new Set())).add("src/App.vue");
+  return _sfc_setup ? _sfc_setup(props, ctx) : void 0;
+};
+const App = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-f4406005"]]);
+export {
+  App as default
+};
diff --git a/dist-ssr/vue-ssr.js b/dist-ssr/vue-ssr.js
new file mode 100644
index 0000000..ab43b8c
--- /dev/null
+++ b/dist-ssr/vue-ssr.js
@@ -0,0 +1,15 @@
+import { createSSRApp } from "vue";
+import { renderToString } from "vue/server-renderer";
+const components = /* @__PURE__ */ Object.assign({ "/src/App.vue": () => import("./App.js") });
+async function render(componentPath, props) {
+  const loader = components[componentPath];
+  if (!loader) {
+    throw new Error(`[Coldspa SSR] No Vue component registered for path "${componentPath}".`);
+  }
+  const mod = await loader();
+  const app = createSSRApp(mod.default, props);
+  return await renderToString(app);
+}
+export {
+  render
+};
diff --git a/package-lock.json b/package-lock.json
index 8525068..62f17bd 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -12,6 +12,7 @@
             },
             "devDependencies": {
                 "@vitejs/plugin-vue": "^5.0.0",
+                "cross-env": "^7.0.3",
                 "vite": "^5.0.0"
             }
         },
@@ -929,6 +930,40 @@
             "integrity": "sha512-5vR2QIlmaLG77Ygd4pMP6+SGQ5yox9VhtnbDWTy9DzMzdmeLxZ1QqxrywEZ9sa1AVubfIJyaCG3ytyWU81ufcQ==",
             "license": "MIT"
         },
+        "node_modules/cross-env": {
+            "version": "7.0.3",
+            "resolved": "https://registry.npmjs.org/cross-env/-/cross-env-7.0.3.tgz",
+            "integrity": "sha512-+/HKd6EgcQCJGh2PSjZuUitQBQynKor4wrFbRg4DtAgS1aWO+gU52xpH7M9ScGgXSYmAVS9bIJ8EzuaGw0oNAw==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "cross-spawn": "^7.0.1"
+            },
+            "bin": {
+                "cross-env": "src/bin/cross-env.js",
+                "cross-env-shell": "src/bin/cross-env-shell.js"
+            },
+            "engines": {
+                "node": ">=10.14",
+                "npm": ">=6",
+                "yarn": ">=1"
+            }
+        },
+        "node_modules/cross-spawn": {
+            "version": "7.0.6",
+            "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz",
+            "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "path-key": "^3.1.0",
+                "shebang-command": "^2.0.0",
+                "which": "^2.0.1"
+            },
+            "engines": {
+                "node": ">= 8"
+            }
+        },
         "node_modules/csstype": {
             "version": "3.2.3",
             "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.2.3.tgz",
@@ -1007,6 +1042,13 @@
                 "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
             }
         },
+        "node_modules/isexe": {
+            "version": "2.0.0",
+            "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
+            "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==",
+            "dev": true,
+            "license": "ISC"
+        },
         "node_modules/magic-string": {
             "version": "0.30.21",
             "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz",
@@ -1034,6 +1076,16 @@
                 "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
             }
         },
+        "node_modules/path-key": {
+            "version": "3.1.1",
+            "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz",
+            "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==",
+            "dev": true,
+            "license": "MIT",
+            "engines": {
+                "node": ">=8"
+            }
+        },
         "node_modules/picocolors": {
             "version": "1.1.1",
             "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
@@ -1113,6 +1165,29 @@
                 "fsevents": "~2.3.2"
             }
         },
+        "node_modules/shebang-command": {
+            "version": "2.0.0",
+            "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
+            "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "shebang-regex": "^3.0.0"
+            },
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/shebang-regex": {
+            "version": "3.0.0",
+            "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz",
+            "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==",
+            "dev": true,
+            "license": "MIT",
+            "engines": {
+                "node": ">=8"
+            }
+        },
         "node_modules/source-map-js": {
             "version": "1.2.1",
             "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
@@ -1204,6 +1279,22 @@
                     "optional": true
                 }
             }
+        },
+        "node_modules/which": {
+            "version": "2.0.2",
+            "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
+            "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==",
+            "dev": true,
+            "license": "ISC",
+            "dependencies": {
+                "isexe": "^2.0.0"
+            },
+            "bin": {
+                "node-which": "bin/node-which"
+            },
+            "engines": {
+                "node": ">= 8"
+            }
         }
     }
 }
diff --git a/package.json b/package.json
index 2c12f68..752caac 100644
--- a/package.json
+++ b/package.json
@@ -5,13 +5,18 @@
     "type": "module",
     "scripts": {
         "dev": "vite",
-        "build": "vite build"
+        "ssr": "node coldspa/vite/ssr-server.js",
+        "ssr:prod": "cross-env NODE_ENV=production node coldspa/vite/ssr-server.js",
+        "build": "vite build && cross-env COLDSPA_SSR=1 vite build",
+        "build:client": "vite build",
+        "build:ssr": "cross-env COLDSPA_SSR=1 vite build"
     },
     "dependencies": {
         "vue": "^3.4.0"
     },
     "devDependencies": {
         "@vitejs/plugin-vue": "^5.0.0",
+        "cross-env": "^7.0.3",
         "vite": "^5.0.0"
     }
 }