diff --git a/README.md b/README.md
index fc4d32b..b126bde 100644
--- a/README.md
+++ b/README.md
@@ -89,4 +89,14 @@ or only the compon you need:
 ```scss
 @use 'path-to-node_modules/mdc-pug/lib/styles/button';
 @use 'path-to-node_modules/mdc-pug/lib/styles/typography';
-```
\ No newline at end of file
+```
+
+### Docs
+
+The documentation pages can be served from the package repo:
+
+1. Clone `https://github.com/olegpolyakov/mdc-pug.git`
+1. `cd mdc-pug`
+1. `npm install`
+1. `npm run docs`
+1. Browse to http://localhost:8080