diff --git a/packages/web-pkg/README.md b/packages/web-pkg/README.md
index 0461fd005cc..dc16fa856e4 100644
--- a/packages/web-pkg/README.md
+++ b/packages/web-pkg/README.md
@@ -7,9 +7,11 @@
 Depending on your package manager, run one of the following commands:
 
 ```
-$ npm install @ownclouders/web-pkg
+$ npm install @ownclouders/web-pkg --save-dev
 
-$ pnpm add @ownclouders/web-pkg
+$ pnpm add -D @ownclouders/web-pkg
 
-$ yarn add @ownclouders/web-pkg
+$ yarn add @ownclouders/web-pkg --dev
 ```
+
+It's recommended to install this package as a dev dependency because it's only really needed for providing autocompletion in your IDE and unit tests. In a runtime context, the ownCloud Web runtime provides the actual implementation.