{"id":20883,"library":"zephyr-webpack-plugin","title":"Zephyr","description":"Zephyr is a modern cloud deployment platform for frontend applications, offering a Webpack plugin to seamlessly integrate deployments into your build pipeline. The current stable version is 1.0.2, with a monthly release cadence. Key differentiators include support for incremental builds, SSR, and Nuxt/Vite integrations, plus a focus on security audits and vulnerability remediation. Unlike alternatives, Zephyr provides a unified CLI and plugin ecosystem for Webpack, Vite, and Slidev, with TypeScript types included.","status":"active","version":"1.0.2","language":"javascript","source_language":"en","source_url":"https://github.com/ZephyrCloudIO/zephyr-packages","tags":["javascript","typescript"],"install":[{"cmd":"npm install zephyr-webpack-plugin","lang":"bash","label":"npm"},{"cmd":"yarn add zephyr-webpack-plugin","lang":"bash","label":"yarn"},{"cmd":"pnpm add zephyr-webpack-plugin","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"peer dependency for the plugin","package":"webpack","optional":false}],"imports":[{"note":"ESM-only since v1.0.0; CommonJS not supported.","wrong":"const ZephyrWebpackPlugin = require('zephyr-webpack-plugin')","symbol":"ZephyrWebpackPlugin","correct":"import { ZephyrWebpackPlugin } from 'zephyr-webpack-plugin'"},{"note":"Use destructured require for CJS; default export is not available.","wrong":"const ZephyrWebpackPlugin = require('zephyr-webpack-plugin').default","symbol":"ZephyrWebpackPlugin","correct":"const { ZephyrWebpackPlugin } = require('zephyr-webpack-plugin')"},{"note":"ZephyrConfigOptions is a TypeScript type-only export; use import type.","wrong":"import { ZephyrConfigOptions } from 'zephyr-webpack-plugin'","symbol":"ZephyrConfigOptions","correct":"import type { ZephyrConfigOptions } from 'zephyr-webpack-plugin'"}],"quickstart":{"code":"// webpack.config.js\nconst { ZephyrWebpackPlugin } = require('zephyr-webpack-plugin');\n\nmodule.exports = {\n  plugins: [\n    new ZephyrWebpackPlugin({\n      token: process.env.ZEPHYR_TOKEN ?? '',\n      projectName: 'my-app',\n      organization: 'my-org',\n    }),\n  ],\n};","lang":"javascript","description":"Shows basic plugin configuration with required token, project name, and organization."},"warnings":[{"fix":"Switch to ESM imports: import { ZephyrWebpackPlugin } from 'zephyr-webpack-plugin'","message":"Version 1.0.0 dropped CommonJS support; use ESM imports.","severity":"breaking","affected_versions":"<1.0.0"},{"fix":"Replace `authToken` with `token` in plugin options.","message":"The v0.x API property `authToken` was renamed to `token` in v1.0.0.","severity":"deprecated","affected_versions":"<1.0.0"},{"fix":"Upgrade to Webpack 5 and set peer dependency webpack@^5.0.0.","message":"Webpack 4 support removed in v0.2.0; Webpack 5 required.","severity":"breaking","affected_versions":"<0.2.0"},{"fix":"Add ZephyrWebpackPlugin as the last plugin in the array.","message":"Plugin must be placed after other webpack plugins to ensure build stats are captured correctly.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Run `npm install zephyr-webpack-plugin` or check node_modules.","cause":"Missing local installation or incorrect path.","error":"Error: Cannot find module 'zephyr-webpack-plugin'"},{"fix":"Use `import { ZephyrWebpackPlugin } from 'zephyr-webpack-plugin'`.","cause":"Using default import instead of named import in ESM.","error":"TypeError: ZephyrWebpackPlugin is not a constructor"},{"fix":"Set process.env.ZEPHYR_TOKEN or pass token property.","cause":"Missing or empty token in plugin options.","error":"Error: The 'token' option is required. Please provide a valid Zephyr API token."}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}