Maaz Zindani

Loading the index…

↑↓ move↵ openesc close4072 pages
Next.js and React

Module not found for antd/dist/antd.less after upgrading to Ant Design 5

ErrorModule not found: Error: Can't resolve 'antd/dist/antd.less'

Short answer

Ant Design 5 dropped Less and the bundled CSS file for CSS-in-JS, so antd/dist/antd.less no longer exists. Delete that import. Styles load by themselves. Import antd/dist/reset.css if you want the basic reset, and use the compatible package only if you need v4 looks or Less variables.

  • Applies to antd 5, React 19, webpack 5
  • Updated
  • By Maaz Zindani, Senior Software Engineer

Fix it fast

  1. 1Find out which cause you have

    Find every import of antd stylesheets and every babel-plugin-import entry. These are what the v4 setup needed and v5 no longer has.

    grep -rnE "antd/(dist|es|lib)/.*\.(less|css)|babel-plugin-import" src package.json .babelrc* babel.config.* 2>/dev/null
  2. 2Match what you see, then jump to its fix

    1. 1The error points at an import 'antd/dist/antd.less' (or antd.css) line.The v4 style import is still in the codeFix
    2. 2The babel config has an import plugin entry for antd with libraryDirectory.babel-plugin-import is still configuredFix
    3. 3A .less file has an @import of '~antd/es/style/themes/index' or uses antd variables.Your own Less files import antd's Less or need its variablesFix

What does the error look like?

  • Module not found: Error: Can't resolve 'antd/dist/antd.less'

Cause 1 of 3

The v4 style import is still in the code

1Check

The v5 migration guide says all Less files are removed and CSS files are no longer in the package; antd.css was dropped because CSS-in-JS imports styles on demand.

ls node_modules/antd/dist | head

2Fix

Delete the import. If you want the basic style reset, import reset.css instead.

// remove:
// import 'antd/dist/antd.less';
// optional:
import 'antd/dist/reset.css';

3Verify

The build passes and the components keep their styles.

npm run build

Confirmed by 5x.ant.design

Did this fix it?

Cause 2 of 3

babel-plugin-import is still configured

1Check

The guide says babel-plugin-import is no longer supported in v5.

grep -rn "libraryName" .babelrc* babel.config.* package.json 2>/dev/null

2Fix

Remove the antd entry from the plugin list.

"plugins": [
-  ["import", { "libraryName": "antd", "libraryDirectory": "lib" }, "antd"]
]

3Verify

A clean build finishes with no antd style resolution error.

rm -rf node_modules/.cache && npm run build

Confirmed by 5x.ant.design

Did this fix it?

Cause 3 of 3

Your own Less files import antd's Less or need its variables

1Check

v5 no longer uses Less internally, so its Less files cannot be imported. The guide offers a compatible package that converts tokens to Less variables for less-loader modifyVars.

grep -rn "antd/es/style" src

2Fix

Remove the antd import from your Less files. To keep the v4 look, wrap the app in ConfigProvider with the v4 theme from the compatible package.

import { defaultTheme } from '@ant-design/compatible';
import { ConfigProvider } from 'antd';

<ConfigProvider theme={defaultTheme}>
  <App />
</ConfigProvider>

3Verify

The app builds and the components show the v4 style.

npm install @ant-design/compatible && npm run build

Confirmed by 5x.ant.design

Did this fix it?

How do I stop it coming back?

  • Read the migration guide before a major upgrade and grep for removed imports first.
  • Keep theming in ConfigProvider tokens instead of Less variables.
  • Remove build plugins that belonged to the old import method.

Sources

How was this page made?

I drafted this page with AI assistance from the official documents listed under Sources. Every cause above names the document that confirms it. I have not reproduced this fix on a machine of my own yet, so read it as documented guidance, not a test report. Found a mistake? Tell me.

Which stack is behind this page?

Projects of mine built on the same technologies:

Related fixes

Next step

Want this handled for good?

I look after servers, apps and releases end to end. Tell me what keeps breaking.