Quick Reference
| Issue | Description | Guide |
|---|---|---|
| Network or connectivity problems | Cannot start Workshop, send messages, or connect to services | Network and Connectivity |
| Workshop seems stuck or confused | Circular suggestions, repeated failures, or inability to solve a problem | Debugging Strategies |
| Project has gotten too complex | Lost in complexity, too many changes without progress | When to Start Fresh |
| Misunderstood requirements | Generated code does not match what you described | Debugging Strategies |
| Technical errors in generated code | Error messages, features that do not work, console warnings | Debugging Strategies |
| Performance issues | Slow application, high memory usage, long loading times | Debugging Strategies |
| Integration difficulties | Problems connecting to APIs, authentication failures | Debugging Strategies |
| Deployment issues | Works locally but fails when deployed | Debugging Strategies |
Common Challenges at a Glance
Workshop Misunderstands Your Requirements
- Be more specific — provide concrete examples and analogies
- Break down complex requests into smaller pieces
- Use the correction pattern: acknowledge what works, identify what needs to change, explain the desired outcome
Technical Errors in Generated Code
- Share the exact error message with Workshop
- Ask for both an explanation and a fix
- Use version control to revert if changes make things worse
- Test small pieces in isolation
Performance Issues
- Ask Workshop to identify the bottleneck
- Request specific optimizations for your use case
- Be open to architecture changes if needed
Integration Difficulties
- Verify API keys and permissions
- Examine request/response data to find formatting issues
- Create a minimal test case before implementing full functionality
Workshop Seems Stuck
- Reset the approach: “Let’s step back. What’s the simplest way to approach this?”
- Provide examples of what you are trying to achieve
- Start a fresh conversation with key context
Connectivity Issues
- Consult the Network and Connectivity guide
- Ensure required domains are accessible on your network
- Upgrade to the latest version of Workshop
Getting Help
If these guides do not resolve your issue:- Discord: Join our community for help from the team and other builders
- Email: Reach out to help@workshop.ai for direct support
- Documentation: Browse the full docs at docs.workshop.ai