{"id":20996,"library":"befly-vite","title":"Befly Vite","description":"Befly Vite 配置预设和插件集合，专为 Vue 3 项目优化，提供开箱即用的 Vite 配置。当前版本 1.6.0，活跃开发中。集成了常用插件（路由、自动导入、图标等）、优化的构建配置（分包、压缩、分析），并支持自定义扩展。与 Vue 3 和 Vite 深度集成，适合快速搭建 Vue 3 项目。注意：需要 Bun >= 1.3.0 作为运行时。","status":"active","version":"1.6.0","language":"javascript","source_language":"en","source_url":null,"tags":["javascript","befly","config","preset","vite","vue"],"install":[{"cmd":"npm install befly-vite","lang":"bash","label":"npm"},{"cmd":"yarn add befly-vite","lang":"bash","label":"yarn"},{"cmd":"pnpm add befly-vite","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"peer dependency, required for Vite configuration","package":"vite","optional":false}],"imports":[{"note":"Package is ESM-only; requires import syntax. CommonJS require will fail.","wrong":"const createBeflyViteConfig = require('befly-vite')","symbol":"createBeflyViteConfig","correct":"import { createBeflyViteConfig } from 'befly-vite'"},{"note":"No default export exists; only named exports.","symbol":"default export","correct":"export { default } from 'befly-vite'"},{"note":"Options type is exported as type only; use import type to avoid runtime error.","wrong":"import { BeflyViteOptions } from 'befly-vite'","symbol":"type definitions","correct":"import type { BeflyViteOptions } from 'befly-vite'"}],"quickstart":{"code":"// vite.config.js\nimport { createBeflyViteConfig } from 'befly-vite';\n\nexport default createBeflyViteConfig();","lang":"javascript","description":"Minimal Vite configuration using befly-vite for a Vue 3 project."},"warnings":[{"fix":"Install Bun 1.3.0 or later and use `bun` command instead of `node`.","message":"Package requires Bun >=1.3.0; Node.js is not supported.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Use ES module import syntax; set `\"type\": \"module\"` in package.json or use .mjs extension.","message":"ESM-only package; CommonJS require() will throw a runtime error.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"If using befly-admin-ui, ensure view files are not under components directory; override exclusion in custom config if needed.","message":"Automatic exclusion of `**/components/**` from befly-admin-ui views routing may cause missing routes.","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":"Add `\"type\": \"module\"` to package.json or rename file to .mjs.","cause":"Using ESM import in a CommonJS context (e.g., without `\"type\": \"module\"` in package.json).","error":"SyntaxError: Cannot use import statement outside a module"},{"fix":"Use import syntax instead of require().","cause":"Attempting to require() the package which is ESM-only.","error":"Error [ERR_REQUIRE_ESM]: require() of ES Module"},{"fix":"Install Bun 1.3.0+ and use `bun install`.","cause":"Running npm install with Node.js or an older version of Bun.","error":"Unsupported engine: befly-vite requires bun >=1.3.0"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}