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

# Troubleshooting

> Known issues without built-in fixes

## Known Issues

<AccordionGroup>
  <Accordion title="Changes not showing in preview" icon="eye-slash">
    **Issue:** Specode confirms changes but they don't appear

    **Workaround:** Always manually refresh the preview window after each change
  </Accordion>

  <Accordion title="Errors not displayed to user" icon="circle-exclamation">
    **Issue:** Build or runtime errors occur but aren't shown in the interface

    **Workaround:** Ask Specode to check for errors if something seems wrong
  </Accordion>

  <Accordion title="Wrong output from vague prompts" icon="shuffle">
    **Issue:** Specode misinterprets unclear instructions

    **Workaround:** Be extremely specific - include exact component names, locations, and desired outcomes
  </Accordion>

  <Accordion title="Server crashes without warning" icon="server">
    **Issue:** Server stops but the interface doesn't indicate it

    **Workaround:** If unresponsive, manually restart the server using the Start Project button
  </Accordion>

  <Accordion title="Preview not loading or showing a blank screen" icon="browser">
    **Issue:** Preview doesn't load or shows connection errors in certain browsers.

    Specode's preview uses web containers, which require a modern Chromium-based browser.

    **Supported browsers:**

    * Chrome
    * Edge
    * Brave
    * Arc
    * Opera

    **Unsupported browsers:**

    * DuckDuckGo
    * Tor Browser
    * Firefox - inconsistent experience
    * Safari 16.4+ - inconsistent experience

    **Recommended browser:** Chrome or any Chromium-based browser (Edge, Brave, Arc).

    If preview isn't loading, try switching to Chrome or another Chromium-based browser.
  </Accordion>

  <Accordion title="Preview shows old content or errors after a fix" icon="rotate">
    **Issue:** Engineering or the AI has fixed an issue, but you still see the old error in your preview.

    **Workaround:** Clear your browser cache for Specode-related sites, or try opening the preview in a different browser (or incognito window). Cached assets from a previous broken state can persist even after the underlying issue is resolved.
  </Accordion>
</AccordionGroup>