{"id":22553,"library":"vite-ember-ssr","title":"vite-ember-ssr","description":"A Vite plugin and SSR/SSG runtime for Ember.js applications using HappyDOM instead of FastBoot. Current version is 0.1.0-alpha.13 (pre-release). Released as experimental alpha with frequent breaking changes. Key differentiators: no FastBoot, no VM sandbox, supports both SSR and SSG modes (including combined), uses HappyDOM for browser environment, requires compatless Embroider setup. Node 22+ and Vite 6+ required.","status":"deprecated","version":"0.1.0-alpha.13","language":"javascript","source_language":"en","source_url":"https://github.com/evoactivity/vite-ember-ssr","tags":["javascript","vite","vite-plugin","ember","emberjs","ssr","server-side-rendering","happydom","embroider"],"install":[{"cmd":"npm install vite-ember-ssr","lang":"bash","label":"npm"},{"cmd":"yarn add vite-ember-ssr","lang":"bash","label":"yarn"},{"cmd":"pnpm add vite-ember-ssr","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"peer dependency, Vite 6 or 7 required","package":"vite","optional":false},{"reason":"required for Ember+Vite integration","package":"@embroider/vite","optional":false},{"reason":"used for server-side DOM simulation","package":"happy-dom","optional":false}],"imports":[{"note":"ESM-only, do not use require(). Import from 'vite-ember-ssr/vite-plugin', not root.","wrong":"const emberSsr = require('vite-ember-ssr/vite-plugin')","symbol":"emberSsr","correct":"import { emberSsr } from 'vite-ember-ssr/vite-plugin'"},{"note":"Named export in subpath. Default import from root does not exist.","wrong":"import emberSsg from 'vite-ember-ssr'","symbol":"emberSsg","correct":"import { emberSsg } from 'vite-ember-ssr/vite-plugin'"},{"note":"Server-side render function is in the 'server' subpath. Node.js runtime only.","wrong":"import { render } from 'vite-ember-ssr'","symbol":"render","correct":"import { render } from 'vite-ember-ssr/server'"}],"quickstart":{"code":"// vite.config.mjs\nimport { defineConfig } from 'vite';\nimport { extensions, ember } from '@embroider/vite';\nimport { babel } from '@rollup/plugin-babel';\nimport { emberSsr } from 'vite-ember-ssr/vite-plugin';\n\nexport default defineConfig({\n  plugins: [\n    ember(),\n    babel({ babelHelpers: 'runtime', extensions }),\n    emberSsr(),\n  ],\n});","lang":"typescript","description":"Minimal Vite config for SSR with Ember via vite-ember-ssr."},"warnings":[{"fix":"Upgrade Node to 22+ and Vite to ^6.0.0 || ^7.0.0.","message":"Requires Node 22+ and Vite 6+. Older versions of Node or Vite will not work.","severity":"breaking","affected_versions":"<0.1.0-alpha.13"},{"fix":"Use import { emberSsr } from 'vite-ember-ssr/vite-plugin' and import { render } from 'vite-ember-ssr/server'.","message":"Import paths changed: plugin exports from 'vite-ember-ssr/vite-plugin', server from 'vite-ember-ssr/server'. Root import is not available.","severity":"breaking","affected_versions":">=0.1.0-alpha.0"},{"fix":"Wait for stable release or pin exact version. Monitor changelog.","message":"All versions are alpha/pre-release. APIs may break without notice. Not suitable for production.","severity":"deprecated","affected_versions":"*"},{"fix":"Pin to exact version in package.json. Do not use ranges.","message":"The package is experimental. No semantic versioning during alpha. Breaking changes in minor/patch bumps are expected.","severity":"gotcha","affected_versions":"<1.0.0"},{"fix":"Migrate Ember app to compatless mode (remove ember-cli-build.js, classicEmberSupport, etc.).","message":"Must use compatless Embroider mode. Classic Ember or @embroider/compat setups are not supported.","severity":"gotcha","affected_versions":"*"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Use import syntax in vite.config.mjs or set type:module in package.json.","cause":"Using require() to load an ESM-only package.","error":"ERR_REQUIRE_ESM: require() of ES Module /path/to/vite-ember-ssr/vite-plugin.mjs from /path/to/vite.config.js not supported."},{"fix":"Install vite-ember-ssr as devDependency and import from 'vite-ember-ssr/vite-plugin'.","cause":"Importing from wrong path or package not installed.","error":"Cannot find module 'vite-ember-ssr/vite-plugin' or its corresponding type declarations."},{"fix":"Remove @embroider/compat and ember-cli-build.js. Ensure app is compatless.","cause":"Using classic Ember compat mode.","error":"Error: The current Ember application uses @embroider/compat which is not supported by vite-ember-ssr."},{"fix":"Replace import config from './config/environment' and ensure it's a standard module export.","cause":"config/environment must be a direct ES module import, not using @embroider/config-meta-loader.","error":"TypeError: config.environment is not a function or module not found."}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}