Registry / web-framework / vite-ember-ssr

vite-ember-ssr

library0.1.0-alpha.13jsnpmunverified

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.

web-framework devops

npm install vite-ember-ssr

github ↗package ↗

INSTALL

IMPORT

SIG · VITE-EMBER-SSR

vite-ember-ssr

web-frameworkjavascriptv0.1.0-alpha.13

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

emberSsr

✓ import { emberSsr } from 'vite-ember-ssr/vite-plugin'

✗ const emberSsr = require('vite-ember-ssr/vite-plugin')

ESM-only, do not use require(). Import from 'vite-ember-ssr/vite-plugin', not root.

emberSsg

✓ import { emberSsg } from 'vite-ember-ssr/vite-plugin'

✗ import emberSsg from 'vite-ember-ssr'

Named export in subpath. Default import from root does not exist.

render

✓ import { render } from 'vite-ember-ssr/server'

✗ import { render } from 'vite-ember-ssr'

Server-side render function is in the 'server' subpath. Node.js runtime only.

Minimal Vite config for SSR with Ember via vite-ember-ssr.

// vite.config.mjs import { defineConfig } from 'vite'; import { extensions, ember } from '@embroider/vite'; import { babel } from '@rollup/plugin-babel'; import { emberSsr } from 'vite-ember-ssr/vite-plugin'; export default defineConfig({ plugins: [ ember(), babel({ babelHelpers: 'runtime', extensions }), emberSsr(), ], });

vite --version

Debug

Known issues

breakingRequires Node 22+ and Vite 6+. Older versions of Node or Vite will not work.

fix

Upgrade Node to 22+ and Vite to ^6.0.0 || ^7.0.0.

affects: <0.1.0-alpha.13

breakingImport paths changed: plugin exports from 'vite-ember-ssr/vite-plugin', server from 'vite-ember-ssr/server'. Root import is not available.

fix

Use import { emberSsr } from 'vite-ember-ssr/vite-plugin' and import { render } from 'vite-ember-ssr/server'.

affects: >=0.1.0-alpha.0

deprecatedAll versions are alpha/pre-release. APIs may break without notice. Not suitable for production.

fix

Wait for stable release or pin exact version. Monitor changelog.

affects: *

gotchaThe package is experimental. No semantic versioning during alpha. Breaking changes in minor/patch bumps are expected.

fix

Pin to exact version in package.json. Do not use ranges.

affects: <1.0.0

gotchaMust use compatless Embroider mode. Classic Ember or @embroider/compat setups are not supported.

fix

Migrate Ember app to compatless mode (remove ember-cli-build.js, classicEmberSupport, etc.).

affects: *

Errors

Common errors & fixes

ERR_REQUIRE_ESM: require() of ES Module /path/to/vite-ember-ssr/vite-plugin.mjs from /path/to/vite.config.js not supported.

Using require() to load an ESM-only package.

fix

Use import syntax in vite.config.mjs or set type:module in package.json.

Cannot find module 'vite-ember-ssr/vite-plugin' or its corresponding type declarations.

Importing from wrong path or package not installed.

fix

Install vite-ember-ssr as devDependency and import from 'vite-ember-ssr/vite-plugin'.

Error: The current Ember application uses @embroider/compat which is not supported by vite-ember-ssr.

Using classic Ember compat mode.

fix

Remove @embroider/compat and ember-cli-build.js. Ensure app is compatless.

TypeError: config.environment is not a function or module not found.

config/environment must be a direct ES module import, not using @embroider/config-meta-loader.

fix

Replace import config from './config/environment' and ensure it's a standard module export.

Upgrade

Version history

0.1.0-alpha.13latest on npm

Audit

Dependencies

viterequiredpeer dependency, Vite 6 or 7 required

@embroider/viterequiredrequired for Ember+Vite integration

happy-domrequiredused for server-side DOM simulation

Agent activity

6 hits · last 30 days

node

Resources

githubhttps://github.com/evoactivity/vite-ember-ssr ↗

packagehttps://www.npmjs.com/package/vite-ember-ssr ↗