{"id":18183,"library":"build-plugin-speed","title":"build-plugin-speed","description":"A build-scripts plugin that logs build time information for ice.js projects. Current stable version is 1.0.1. Released as part of the Alibaba ice framework ecosystem. It is a minimal plugin that outputs build speed metrics to the console during development and production builds. Differentiators: simple integration with ice.js build-scripts, no external dependencies.","status":"active","version":"1.0.1","language":"javascript","source_language":"en","source_url":"https://github.com/alibaba/ice/tree/master/packages/plugin-vite","tags":["javascript","plugin","react"],"install":[{"cmd":"npm install build-plugin-speed","lang":"bash","label":"npm"},{"cmd":"yarn add build-plugin-speed","lang":"bash","label":"yarn"},{"cmd":"pnpm add build-plugin-speed","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"Default export is the plugin function. Expected to be used in build.config.js or ice.config.mts.","symbol":"default","correct":"import buildPluginSpeed from 'build-plugin-speed'"},{"note":"CJS usage: the package provides a CommonJS entry; no .default needed.","wrong":"const buildPluginSpeed = require('build-plugin-speed').default","symbol":"default (require)","correct":"const buildPluginSpeed = require('build-plugin-speed')"},{"note":"Type imports should come from build-scripts, not from this plugin.","symbol":"Plugin type","correct":"import type { IPlugin } from 'build-scripts'"}],"quickstart":{"code":"// ice.config.mts or build.config.js\nimport buildPluginSpeed from 'build-plugin-speed';\n\nexport default defineConfig({\n  plugins: [\n    buildPluginSpeed()\n  ]\n});","lang":"typescript","description":"Shows how to add the build-plugin-speed plugin to an ice.js project's build config."},"warnings":[{"fix":"Ensure the import matches the package name exactly.","message":"Plugin name must be exactly 'build-plugin-speed' in the plugins array; mismatched casing will silently fail.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Migrate to @ice/plugin-speed following the ice v3 upgrade guide.","message":"The package is marked as deprecated; consider using @ice/plugin-speed instead.","severity":"deprecated","affected_versions":">=1.0.0"},{"fix":"Update build-scripts to version 2.0.0 or higher.","message":"Plugin only works with build-scripts v2.x and above; older versions will not load it.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Run npm install build-plugin-speed --save-dev and ensure the import path is correct.","cause":"Package not installed or incorrectly imported.","error":"Error: Cannot find module 'build-plugin-speed'"},{"fix":"Ensure the default export is invoked as buildPluginSpeed() in the plugins array.","cause":"Using default import but package exports an object instead of a function.","error":"TypeError: buildPluginSpeed is not a function"},{"fix":"Use the exact package name 'build-plugin-speed' (string) or the imported function.","cause":"Plugin name mismatch or wrong format in plugins array.","error":"Plugin 'build-plugin-speed' does not exist or is invalid"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}