Managing Node yourself? If you’d rather run Vite/SSR under systemd, docker-compose, or your platform’s process supervisor, set COLDSPA_NO_BOOTSTRAP=1 in the CF process env. Bootstrap.onApplicationStart will still cache config but skip the spawn. Coldspa also auto-detects this when npm isn’t on PATH (the typical CF-in-Docker case) — see Docker & cross-host setups.
Coldspa lists every runtime framework package as an optional peer dependency, so you only install what you actually use. Install the matching Vite framework plugin in your app because your Vite config owns that setup.
The plugin handles framework sub-plugins, client-entry shims, manifest output, and dev-server host binding for you.
+
vite.config.js
import { defineConfig } from'vite';
import vue from'@vitejs/plugin-vue';
import coldspa from'coldspa/vite';
+
exportdefaultdefineConfig({
plugins: [
vue(),
coldspa({
frameworks: ['vue'],
globs: {
vue: '/src/**/*.vue'
}
})
]
});
+
For React, import react from @vitejs/plugin-react, add react() to plugins, and set frameworks: ['react']. For mixed Vue + React configs, include both framework plugins before coldspa(...).
+
The Coldspa plugin handles client-entry shims, manifest output, and dev-server host binding for you.
The ssr script can also be invoked via the coldspa-ssr bin shipped in the npm package.
+
{
"scripts": {
"dev": "vite",
"ssr": "coldspa-ssr",
"build": "vite build && cross-env COLDSPA_SSR=1 vite build",
"ssr:prod": "coldspa-ssr --prod"
}
}
+
coldspa-ssr is the SSR sidecar binary shipped in the npm package. Keeping it behind an ssr script lets coldspa.Bootstrap start the sidecar automatically with npm run ssr.
+
If Vite’s dependency optimizer cache needs to be rebuilt during development, run the sidecar with coldspa-ssr --force or npm run ssr -- --force.
Mount Vue or React components into CFML pages with server-side rendering and progressive hydration. Coldspa brings the islands architecture popularized by Astro to ColdFusion, so you can keep rendering pages with CFML while sprinkling in interactive widgets that hydrate on demand.
