Troubleshooting

Quick solutions to resolve common issues with the Mix development environment.

Quick Diagnostics

Run these commands first to identify common issues:

make test-all      # Run all validation tests

Ask Claude

All development logs (backend, frontend, browser console) are unified in a single log file.

To debug issues, ask Claude Code to check the logs:

make tail-log    # Shows last 100 lines

Claude can analyze the output to identify and fix errors. See AI-assisted coding to see how this works.

Still not working ?

If issues persist after trying these solutions:

1. Run make test-all and save the output
2. Check detailed logs with make tail-log
3. Create a GitHub issue with:
   • Problem description
   • Steps to reproduce
   • Output from validation tests
   • Relevant log sections