troubleshooting-guide

What problem does it solve?

This Skill provides a systematic, comprehensive guide for diagnosing and resolving common Wasp development issues, from import errors and auth problems to database conflicts and stale types. It drastically reduces debugging time and developer frustration.

Core Features & Use Cases

• Systematic Diagnostic Approach: Offers a decision tree to quickly classify errors and directs users to specific, actionable troubleshooting procedures.
• Error Index & Solutions: Catalogs common error messages and symptoms, providing targeted fixes for import/type errors, operation issues, auth problems, database conflicts, and more.
• Quick Fixes Checklist: Summarizes universal and category-specific fixes, enabling rapid resolution of most development blockers.
• Use Case: You encounter a "Cannot find module 'wasp/entities'" error. Use this Skill to quickly identify the cause (e.g., forgot to restart Wasp) and apply the correct fix, getting your development environment back on track in minutes.

Quick Start

I'm encountering a "Cannot find module 'wasp/entities'" error. Provide the diagnostic steps and common fixes for this issue.