Skip to main content

Part 9: Troubleshooting - When Things Go Wrong

· One min read
Mike Stabile
Mike Stabile
AI Integration Specialist & Developer

Software development is a series of moments when you transition from denial to acceptance. Let's catalog the disasters.

"Module Not Found"​

Fix: Update import paths to use @site/src/components/

"Tailwind Classes Not Working"​

Fix: Use Tailwind v3.4.1, not v4. Check content paths. Set preflight: false.

"Modal/Overlay Not Appearing"​

Fix: Add z-index: 9999 !important to modal CSS.

"Changes Not Appearing"​

Fix: npm run clear && npm start

The Universal Troubleshooting Protocol​

  1. Read the error message entirely
  2. Clear the cache
  3. Check recent changes
  4. Isolate the problem
  5. Search the error
  6. Check Docusaurus issues on GitHub

Next: Part 10 - Best Practices: The Wisdom of Experience