diff --git a/docs/guide/README.md b/docs/guide/README.md
index 9e4a7b2e6..3af08bd39 100644
--- a/docs/guide/README.md
+++ b/docs/guide/README.md
@@ -86,3 +86,7 @@ module.exports = {
 ```
 
 Also see [Options Reference](../options.md) for all available loader options.
+
+::: warning
+If you are developing a library or in a monorepo, please be aware that CSS imports **are side effects**. Make sure to **remove** `"sideEffects": false` in the `package.json`, otherwise CSS chunks will be dropped by webpack in production builds.
+:::