{"id":22554,"library":"vite-enhancer-config","title":"vite-enhancer-config","description":"A zero-config plugin that enhances Vite configuration for React applications with production-grade optimizations. Current stable version 1.3.6. Integrates SWC for fast compilation (5-10x faster), automatic Fast Refresh (HMR), and built-in bundle analysis. Ships TypeScript types. Requires Vite v4, v5, or v6 and Node >=18. Differentiator: opinionated, minimal setup with automatic production defaults for React projects.","status":"active","version":"1.3.6","language":"javascript","source_language":"en","source_url":"https://github.com/Johnsmithali.ld/vite-enhancer-config","tags":["javascript","vite","react","plugin","config","enhancer","production","optimization","build-tools","typescript"],"install":[{"cmd":"npm install vite-enhancer-config","lang":"bash","label":"npm"},{"cmd":"yarn add vite-enhancer-config","lang":"bash","label":"yarn"},{"cmd":"pnpm add vite-enhancer-config","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"peer dependency for Vite plugin","package":"vite","optional":false},{"reason":"works with React projects","package":"react","optional":true}],"imports":[{"note":"ESM-only export; CommonJS require will fail.","wrong":"const viteEnhancerConfig = require('vite-enhancer-config')","symbol":"viteEnhancerConfig","correct":"import { viteEnhancerConfig } from 'vite-enhancer-config'"},{"note":"Default import is supported since v1.0. Named export is also available.","wrong":"import { default as config } from 'vite-enhancer-config'","symbol":"default","correct":"import viteEnhancerConfig from 'vite-enhancer-config'"},{"note":"Use `import type` for type-only imports to avoid runtime errors.","wrong":"import { ViteEnhancerOptions } from 'vite-enhancer-config'","symbol":"ViteEnhancerOptions","correct":"import type { ViteEnhancerOptions } from 'vite-enhancer-config'"}],"quickstart":{"code":"import { defineConfig } from 'vite';\nimport react from '@vitejs/plugin-react';\nimport { viteEnhancerConfig } from 'vite-enhancer-config';\n\nexport default defineConfig({\n  plugins: [\n    react(),\n    viteEnhancerConfig({\n      swc: true,\n      analyzer: true,\n      apiKey: process.env.ANALYZER_KEY ?? ''\n    })\n  ]\n});","lang":"typescript","description":"Adds SWC compilation and bundle analysis to an existing Vite React setup with typed options."},"warnings":[{"fix":"Use dynamic import or switch to ESM.","message":"Using CommonJS require will fail because the package is ESM-only.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Replace `analyzerKey` with `apiKey` in configuration.","message":"Option `analyzerKey` was renamed to `apiKey` in v1.3.0.","severity":"deprecated","affected_versions":">=1.3.0"},{"fix":"Remove any manual SWC plugin from plugins array when swc option is enabled.","message":"SWC plugin may conflict with Babel-based React plugins (e.g., @vitejs/plugin-react-swc is not needed).","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Upgrade Node.js to v18 or later.","message":"Node 18 minimum required; older versions will throw a syntax error.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Set `analyzer` mode to `static` or disable in non-interactive environments.","message":"Bundle analyzer opens a browser on build; may block CI if not configured.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Run `npm install vite-enhancer-config -D`.","cause":"Package not installed or not in node_modules.","error":"Error [ERR_MODULE_NOT_FOUND]: Cannot find package 'vite-enhancer-config' imported from ..."},{"fix":"Use `import { viteEnhancerConfig } from 'vite-enhancer-config'`.","cause":"Wrong import style (CommonJS require on ESM-only package).","error":"TypeError: viteEnhancerConfig is not a function"},{"fix":"Add `\"type\":\"module\"` to package.json or rename file to .mjs.","cause":"Project not configured as ESM (no 'type':'module' in package.json).","error":"Error: Cannot use import statement outside a module"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}