Skip to content
Home / Migrations / Sass legacy JS APISass modern API

Sass legacy JS API Sass modern API

easy

The Sass legacy JS API (renderSync/render) is deprecated. Modern API (compile/compileString) is faster, required by Vite 6+, and supports custom importers.

Estimated: 0.5-1h · 4 steps
Progress0%
Step 1: Update sass package
npm install sass@latest
Step 2: Update bundler config

Vite: css.preprocessorOptions.scss.api = 'modern-compiler'. Webpack sass-loader: api: 'modern-compiler'.

Step 3: Fix custom Sass usage

If calling Sass directly: sass.renderSync() → sass.compile(). sass.render() → sass.compileAsync(). Options format changed.

Step 4: Test styles
All SCSS compiles. No deprecation warnings. Build output unchanged.