diff --git a/README.md b/README.md
index 7a78de805..6918c8cc6 100644
--- a/README.md
+++ b/README.md
@@ -91,13 +91,15 @@ Getting started with **Docz** is really quick and easy.
 Firstly, install `docz` and a theme of your choosing using your favourite package manager:
 
 ```bash
-$ yarn add --dev docz docz-theme-default
+$ yarn add --dev docz docz-theme-default react react-dom
 
 # or
 
-$ npm install --save-dev docz docz-theme-default
+$ npm install --save-dev docz docz-theme-default react react-dom
 ```
 
+**Note**: `react` and `react-dom` will not be installed automatically. You'll have to install them yourself.
+
 Next, add some `.mdx` files anywhere inside your project:
 
 ```markdown
diff --git a/core/docz-theme-default/package.json b/core/docz-theme-default/package.json
index a8765f66e..766ef6df5 100644
--- a/core/docz-theme-default/package.json
+++ b/core/docz-theme-default/package.json
@@ -31,9 +31,7 @@
     "polished": "^3.3.0",
     "prop-types": "15.7.2",
     "re-resizable": "^4.11.0",
-    "react": "^16.8.6",
     "react-codemirror2": "^6.0.0",
-    "react-dom": "^16.8.6",
     "react-feather": "^1.1.6",
     "react-live": "2.0.1",
     "react-perfect-scrollbar": "^1.5.0",
diff --git a/core/docz/package.json b/core/docz/package.json
index 11330fe90..a1370b262 100644
--- a/core/docz/package.json
+++ b/core/docz/package.json
@@ -33,8 +33,6 @@
     "lodash": "^4.17.11",
     "match-sorter": "^3.0.0",
     "prop-types": "^15.7.2",
-    "react": "^16.8.6",
-    "react-dom": "^16.8.6",
     "ulid": "^2.3.0",
     "yargs": "^13.2.2"
   },
diff --git a/core/gatsby-theme-docz/package.json b/core/gatsby-theme-docz/package.json
index c46e688e2..6ad458ccf 100644
--- a/core/gatsby-theme-docz/package.json
+++ b/core/gatsby-theme-docz/package.json
@@ -35,8 +35,6 @@
     "gatsby-plugin-styled-components": "^3.0.7",
     "lodash": "^4.17.11",
     "prop-types": "^15.7.2",
-    "react": "^16.8.6",
-    "react-dom": "^16.8.6",
     "react-helmet": "^5.2.1",
     "rehype-docz": "^1.2.0",
     "rehype-slug": "^2.0.2",
@@ -54,5 +52,9 @@
     "eslint-plugin-jsx-a11y": "6.2.1",
     "eslint-plugin-react": "7.13.0",
     "eslint-plugin-react-hooks": "^1.6.0"
+  },
+  "peerDependencies": {
+    "react": "^16.8.0",
+    "react-dom": "^16.8.0"
   }
 }