Registry / devops / vite-plugin-zephyr

vite-plugin-zephyr

library1.0.2jsnpmunverified

Vite plugin (v1.0.2) for integrating Zephyr Cloud's module federation and deployment platform into Vite-based projects. Enables seamless federated module loading, deployment to Zephyr Cloud, and version management. Requires Vite ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0, Rollup ^4.0.0, and @module-federation/vite ^1.13.2. Ships TypeScript types. Key differentiators: purpose-built for Zephyr Cloud with no-config setup and automatic module synchronization. Release cadence: patch releases every few weeks with occasional major bumps.

devops web-framework type-stubs

npm install vite-plugin-zephyr

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · VITE-PLUGIN-ZEPHYR

vite-plugin-zephyr

devopsjavascriptv1.0.2

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.

default (plugin)

✓ import zephyr from 'vite-plugin-zephyr'

✗ const zephyr = require('vite-plugin-zephyr')

ESM-only; CJS require() will fail. Use import syntax.

ZephyrPluginOptions

✓ import type { ZephyrPluginOptions } from 'vite-plugin-zephyr'

TypeScript only; no runtime value.

withZephyr

✓ import { withZephyr } from 'vite-plugin-zephyr'

✗ import withZephyr from 'vite-plugin-zephyr/withZephyr'

Exported as named export from the main package, not a subpath.

Basic Vite config with Zephyr plugin enabling module federation and deployment integration.

import { defineConfig } from 'vite'; import zephyr from 'vite-plugin-zephyr'; export default defineConfig({ plugins: [ zephyr({ // Optional: specify Zephyr project URL or API key projectUrl: process.env.ZEPHYR_PROJECT_URL ?? '', apiKey: process.env.ZEPHYR_API_KEY ?? '', // Enable hot reload for federated modules hotReload: true }) ] });

Debug

Known issues

deprecatedThe 'withZephyr' helper has been deprecated in v1.0.0. Use the default import directly.

fix

Replace `import { withZephyr } from 'vite-plugin-zephyr'` with `import zephyr from 'vite-plugin-zephyr'`.

affects: >=1.0.0

gotchaPlugin must be placed AFTER the Vue or React plugin in the plugins array to ensure correct processing.

fix

Order plugins correctly: `plugins: [vue(), react(), zephyr()]`.

affects: >=0.1.0

breakingv1.0.0 changed the default export from an object to a function. Direct plugin registration without calling the function will fail.

fix

Use `zephyr()` as a function call, not `new zephyr()` or just `zephyr`.

affects: >=1.0.0

gotchaThe plugin requires @module-federation/vite version ^1.13.2. Older or newer major versions may cause incompatibility.

fix

Install compatible version: `npm install @module-federation/vite@^1.13.2`.

affects: >=0.1.0

Errors

Common errors & fixes

Cannot find module 'vite-plugin-zephyr'

CJS require() used instead of ESM import.

fix

Change to `import zephyr from 'vite-plugin-zephyr'` and ensure package.json has `"type": "module"`.

ERR_PNPM_RECURSIVE_RUN ERR vite-plugin-zephyr is not a valid plugin option. Expected a function, got an object.

Using the default export incorrectly without calling it as a function.

fix

Use `zephyr()` instead of `zephyr` in the plugins array.

Module federation build failed: @module-federation/vite version mismatch

Incompatible version of @module-federation/vite installed.

fix

Run `npm install @module-federation/vite@^1.13.2` to install the correct peer dependency.

Upgrade

Version history

1.0.2latest on npm

Audit

Dependencies

viterequiredpeer dependency, plugin runs inside Vite's build pipeline

rolluprequiredpeer dependency, Vite uses Rollup under the hood

@module-federation/viterequiredpeer dependency, core library for module federation integration

Agent activity

33 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/ZephyrCloudIO/zephyr-packages ↗

packagehttps://www.npmjs.com/package/vite-plugin-zephyr ↗

homepagehttps://zephyr-cloud.io ↗