General Errors

This troubleshooting guide covers general errors you may encounter while installing or developing with Medusa and how to resolve them.

Resolve "Cannot find module X" Errors#

This error can occur while installing any of Medusa's projects (for example, Next.js Starter storefront). There is no specific cause to this error.

One way to resolve it is by removing the node_modules directory in the project and re-installing the dependencies:

Was this page helpful?
Ask Bloom
For assistance in your development, use Claude Code Plugins or Medusa MCP server in Cursor, VSCode, etc...FAQ
What is Medusa?
How can I create a module?
How can I create a data model?
How do I create a workflow?
How can I extend a data model in the Product Module?
Recipes
How do I build a marketplace with Medusa?
How do I build digital products with Medusa?
How do I build subscription-based purchases with Medusa?
What other recipes are available in the Medusa documentation?
Chat is cleared on refresh
Line break