docs(errors): CSS Modules Imported by a Dependency (#10034)

errors/css-modules-npm.md

@@ -0,0 +1,24 @@
+# CSS Modules Imported by a Dependency
+
+#### Why This Error Occurred
+
+One of your dependencies (`node_modules`) imports a CSS Modules file.
+
+This normally happens when a package's source files are accidentally consumed,
+instead of the built package.
+
+#### Possible Ways to Fix It
+
+Reach out to the maintainer and ask for them to publish a compiled version of
+their dependency.
+
+Compiled dependencies do not have references to CSS Module files, or any other
+files that require bundler-specific integrations.
+
+The dependency should also provide instructions about what CSS needs to be
+imported by you, in your application.
+
+---
+
+If this is **first party code**, try
+[including said monorepo package in the compilation pipeline](https://github.com/zeit/next.js/tree/canary/examples/with-yarn-workspaces).

packages/next/build/webpack/config/blocks/css/messages.ts

@@ -19,8 +19,9 @@ export function getGlobalModuleImportError() {
 }
 
 export function getLocalModuleImportError() {
-  // TODO: Read more link
   return `CSS Modules ${chalk.bold(
     'cannot'
-  )} be imported from within ${chalk.bold('node_modules')}.`
+  )} be imported from within ${chalk.bold(
+    'node_modules'
+  )}.\nRead more: https://err.sh/next.js/css-modules-npm`
 }