> ## Documentation Index
> Fetch the complete documentation index at: https://docs.workshop.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Common issues and how to resolve them when building with Workshop.

Even with the power of AI, building software can sometimes be challenging. This guide helps you navigate common issues and provides strategies for getting back on track. Problem-solving is part of the building process, even with agentic coding.

## Quick Reference

| Issue                                  | Description                                                              | Guide                                                             |
| -------------------------------------- | ------------------------------------------------------------------------ | ----------------------------------------------------------------- |
| **Network or connectivity problems**   | Cannot start Workshop, send messages, or connect to services             | [Network and Connectivity](/troubleshooting/network-connectivity) |
| **Workshop seems stuck or confused**   | Circular suggestions, repeated failures, or inability to solve a problem | [Debugging Strategies](/troubleshooting/debugging-strategies)     |
| **Project has gotten too complex**     | Lost in complexity, too many changes without progress                    | [When to Start Fresh](/troubleshooting/when-to-start-fresh)       |
| **Misunderstood requirements**         | Generated code does not match what you described                         | [Debugging Strategies](/troubleshooting/debugging-strategies)     |
| **Technical errors in generated code** | Error messages, features that do not work, console warnings              | [Debugging Strategies](/troubleshooting/debugging-strategies)     |
| **Performance issues**                 | Slow application, high memory usage, long loading times                  | [Debugging Strategies](/troubleshooting/debugging-strategies)     |
| **Integration difficulties**           | Problems connecting to APIs, authentication failures                     | [Debugging Strategies](/troubleshooting/debugging-strategies)     |
| **Deployment issues**                  | Works locally but fails when deployed                                    | [Debugging Strategies](/troubleshooting/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](/troubleshooting/network-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](https://discord.gg/ggqJkUN3vx) for help from the team and other builders
* **Email**: Reach out to [help@workshop.ai](mailto:help@workshop.ai) for direct support
* **Documentation**: Browse the full docs at [docs.workshop.ai](https://docs.workshop.ai)

Troubleshooting is a natural part of the development process. By approaching problems methodically, communicating clearly with Workshop, and learning from each challenge, you will become more effective at resolving issues when they arise.