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/package.json b/core/docz/package.json
index ce34a9518..511319313 100644
--- a/core/docz/package.json
+++ b/core/docz/package.json
@@ -34,8 +34,6 @@
     "marksy": "^8.0.0",
     "match-sorter": "^3.1.1",
     "prop-types": "^15.7.2",
-    "react": "^16.8.6",
-    "react-dom": "^16.8.6",
     "ulid": "^2.3.0",
     "yargs": "^13.2.4"
   },
diff --git a/core/gatsby-theme-docz/package.json b/core/gatsby-theme-docz/package.json
index 977ffab28..61b66d26c 100644
--- a/core/gatsby-theme-docz/package.json
+++ b/core/gatsby-theme-docz/package.json
@@ -40,8 +40,6 @@
     "mdx-utils": "^0.2.0",
     "prop-types": "^15.7.2",
     "re-resizable": "^5.0.1",
-    "react": "^16.8.6",
-    "react-dom": "^16.8.6",
     "react-feather": "^2.0.3",
     "react-helmet": "^5.2.1",
     "react-live": "^2.1.2",
@@ -58,5 +56,9 @@
     "babel-eslint": "10.0.2",
     "eslint": "^5.16.0",
     "eslint-config-docz-js": "^1.2.0"
+  },
+  "peerDependencies": {
+    "react": "^16.8.0",
+    "react-dom": "^16.8.0"
   }
 }