Troubleshooting Theseus

• Did you install Theseus? Brackets doesn't have all this magical stuff by default. Follow the installation instructions.

• Did you install Theseus with Brackets before Sprint 26? Did you install Theseus using its GitHub URL instead of the URL of the zip file? Your install may be corrupted. Install it again using the installation instructions.

• In Brackets, click the Debug > Show Developer Tools menu item to open the Developer Tools for Brackets itself. Go to its console. Do you see any error messages that might be related to Theseus? That shouldn't happen. Open an issue about it.

• Are you using Theseus with node-theseus? They're both changing all the time and very few versions of one will work with a particular version of the other. Upgrade node-theseus and Theseus to their latest versions by running npm update -g node-theseus and using the Brackets Extension Manager to remove Theseus and install it again using the installation instructions.

• Are you using Theseus with Chrome? Make sure it's in the right mode. Click File > Mode: Serve files from disk when you're editing a static HTML and JavaScript files. Click File > Mode: Proxy to localhost:3000 (experimental) if your files are served by a separate web server. That server needs to listen on port 3000 for now. Open an issue if that assumption doesn't work for you, because making that number configurable is a pretty low priority otherwise.

• Are you using Theseus with Chrome? Make sure you don't have a "Live Preview Base URL" in your Project Settings. Check by clicking the File > Project Settings... menu item in Brackets. Having a Base URL causes Brackets and Theseus to try to proxy requests and things don't seem to work right. However, Theseus has limited support for proxying on its own as long as your server listens on localhost:3000. Click the menu item File > Mode: Proxy to localhost:3000 (experimental) and remove the Brackets Base URL setting.

• Theseus makes your program use a lot more memory. If that memory starts to page to disk, your program may slow to a crawl. Check how much memory your program is using and compare it with how much free RAM you have.

• Theseus can make some programs very slow. It tries very hard not to, though. If it makes your program too slow to use, please open an issue about it.

• Theseus assumes that paths are case-sensitive. This can cause subtle errors if you reference a file using capitalization that's different from the file's canonical name. Open an issue if you are in a situation where the current naive behavior is insufficient.

• Check the open issues list to see if anyone is already talking about the problem you're having. Open a new issue if they're not.