diff --git a/addons/storysource/README.md b/addons/storysource/README.md
new file mode 100644
index 00000000000..f4daf4f1f07
--- /dev/null
+++ b/addons/storysource/README.md
@@ -0,0 +1,33 @@
+# Storybook Storysource Addon
+
+This addon is used to show stories source in the addon panel.
+
+## Getting Started
+
+First, install the addon
+
+```sh
+npm install -D @storybook/addon-storysource
+```
+
+Add this line to your `addons.js` file
+
+```js
+import '@storybook/addon-storysource/register';
+```
+
+Use this hook to a custom webpack.config. This will generate a decorator call in every story:
+
+```js
+module.exports = {
+  module: {
+    rules: [
+      {
+        test: /\.stories\.jsx?$/,
+        loaders: [require.resolve('@storybook/addon-storysource/loader')],
+        enforce: 'pre',
+      },
+    ],
+  },
+};
+```
\ No newline at end of file