{"id":18182,"library":"build-scripts-config","title":"build-scripts-config","description":"Basic configs for build-scripts and its plugins. Current stable version 3.6.2. Part of Alibaba's ice framework ecosystem. Provides shared configuration presets for build-scripts, including webpack and rspack support. Differentiates by offering AST-based export analysis and support for multiple bundlers.","status":"active","version":"3.0.3","language":"javascript","source_language":"en","source_url":"https://github.com/alibaba/ice/tree/master/packages/build-scripts-config","tags":["javascript","plugin","react","typescript"],"install":[{"cmd":"npm install build-scripts-config","lang":"bash","label":"npm"},{"cmd":"yarn add build-scripts-config","lang":"bash","label":"yarn"},{"cmd":"pnpm add build-scripts-config","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"peer dependency","package":"webpack","optional":false}],"imports":[{"note":"ESM-only since v3","wrong":"const createConfig = require('build-scripts-config')","symbol":"createConfig","correct":"import { createConfig } from 'build-scripts-config'"},{"note":"Named export, not default","wrong":"const { getUserConfig } = require('build-scripts-config')","symbol":"getUserConfig","correct":"import { getUserConfig } from 'build-scripts-config'"},{"note":"Default export is the config object","wrong":"import { default } from 'build-scripts-config'","symbol":"default","correct":"import config from 'build-scripts-config'"}],"quickstart":{"code":"import { defineConfig } from '@ice/app';\nimport config from 'build-scripts-config';\nimport webpack from 'webpack';\n\nexport default defineConfig(() => ({\n  webpack: config.webpack,\n  plugins: [{\n    name: 'example-plugin',\n    apply: (api) => {\n      api.chainWebpack((chain) => {\n        chain.resolve.alias.set('@', __dirname);\n      });\n    },\n  }],\n}));","lang":"typescript","description":"Shows using build-scripts-config to configure webpack in an ice app."},"warnings":[{"fix":"Install webpack@4.41.1 or compatible version: npm install webpack@4.41.1","message":"Peer dependency webpack@^4.41.1 must be installed manually.","severity":"gotcha","affected_versions":">=3.0.0"},{"fix":"Use ES module imports (import syntax) and ensure package.json has type:module or use .mjs extension.","message":"ESM-only in v3: CommonJS require() will not work.","severity":"breaking","affected_versions":">=3.0.0"},{"fix":"Use defineConfig from @ice/app instead of createConfig from build-scripts-config.","message":"createConfig is deprecated in favor of defineConfig from @ice/app.","severity":"deprecated","affected_versions":">=3.5.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"npm install build-scripts-config","cause":"Package not installed","error":"Cannot find module 'build-scripts-config'"},{"fix":"npm install webpack@4.41.1","cause":"Missing webpack peer dependency","error":"TypeError: webpack is not a constructor"},{"fix":"Add type:module to package.json or rename file to .mjs","cause":"Using ESM imports without 'type: module' in package.json","error":"SyntaxError: Cannot use import statement outside a module"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}