Module not found: Can't resolve 'react-dom' error [Solved]

avatar
Borislav Hadzhiev

Last updated: Apr 6, 2024
2 min

banner

# Module not found: Can't resolve 'react-dom' error

To solve the error "Module not found: Error: Can't resolve 'react-dom'", make sure to install the react-dom package by opening your terminal in your project's root directory and running the command npm install react-dom react and restart your development server.

Open your terminal in your project's root directory (where your package.json file is located) and run the following commands:

shell
# ๐Ÿ‘‡๏ธ with NPM npm install react-dom react # ๐Ÿ‘‡๏ธ ONLY If you use TypeScript npm install --save-dev @types/react-dom @types/react # ---------------------------------------------- # ๐Ÿ‘‡๏ธ with YARN yarn add react-dom react # ๐Ÿ‘‡๏ธ ONLY If you use TypeScript yarn add @types/react-dom @types/react --dev

npm install react dom

The command will add the react-dom package to the dependencies of your project.

Make sure to restart your development server and your IDE if necessary. Your dev server won't pick up the changes until you stop it and re-run the npm start command.

You should now be able to import and use the react-dom package in your React.js app.

index.js
import {StrictMode} from 'react'; import {createRoot} from 'react-dom/client'; import App from './App'; // ๐Ÿ‘‡๏ธ IMPORTANT: use the correct ID of your root element // This is the ID of the div in your index.html file const rootElement = document.getElementById('root'); const root = createRoot(rootElement); root.render( <StrictMode> <App /> </StrictMode>, );

# Delete your node_modules and reinstall your dependencies

If the error is not resolved, try to delete your node_modules and package-lock.json (not package.json) files, re-run npm install and restart your IDE.

If you are on macOS or Linux, issue the following commands in bash or zsh.

shell
# for macOS and Linux rm -rf node_modules rm -f package-lock.json rm -f yarn.lock # ๐Ÿ‘‡๏ธ clean your npm cache npm cache clean --force # ๐Ÿ‘‡๏ธ install packages npm install

If you are on Windows, issue the following commands in CMD.

cmd
# for Windows rd /s /q "node_modules" del package-lock.json del -f yarn.lock # ๐Ÿ‘‡๏ธ clean your npm cache npm cache clean --force # ๐Ÿ‘‡๏ธ install packages npm install

Make sure to restart your IDE and dev server if the error persists. VS Code often glitches and a reboot solves things sometimes.

# Verify you have react-dom installed

If you still get the error, open your package.json file and make sure it contains the react-dom package in the dependencies object.

package.json
{ // ... rest "dependencies": { "react": "^18.0.0", "react-dom": "^18.0.0", }, // ๐Ÿ‘‡๏ธ Only if you use TypeScript "devDependencies": { "@types/react": "^17.0.43", "@types/react-dom": "^17.0.14", } }

The react-dom module should NOT be globally installed or be in your project's devDependencies. It should be in the dependencies object in your package.json file.

You can try to manually add the lines and re-run npm install.

shell
npm install

issue npm install

Or install the latest version of the package:

shell
npm install react-dom@latest react@latest # ๐Ÿ‘‡๏ธ ONLY If you use TypeScript npm install --save-dev @types/react-dom@latest @types/react@latest

install react dom latest version

If the error persists, follow the instructions in my Module not found: Can't resolve 'X' error in React article.

I wrote a book in which I share everything I know about how to become a better, more efficient programmer.
book cover
You can use the search field on my Home Page to filter through all of my articles.

Copyright ยฉ 2024 Borislav Hadzhiev