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

# Troubleshooting

> Solutions for common issues with generation, sandbox, deployment, and account.

# Troubleshooting

## Generation issues

<AccordionGroup>
  <Accordion title="Generation seems stuck or takes too long">
    * Check your internet connection
    * Try refreshing the page and generating again
    * If using Max Mode, generation takes longer — this is expected
    * Check your credit balance — generation stops if you have 0 credits
  </Accordion>

  <Accordion title="Generated result doesn't match my prompt">
    * Be more specific in your prompt (mention colors, layout, content explicitly)
    * Use the **Enhance** button to improve your prompt before generating
    * Upload reference images for visual guidance
    * Enable **Deep Design** for more thoughtful results
  </Accordion>

  <Accordion title="Generated screen shows errors">
    * Try editing with AI: "Fix the errors on this page"
    * Open the Sandbox Panel → Vite Logs to see specific error messages
    * Use the Terminal tab to check console output
  </Accordion>
</AccordionGroup>

## Sandbox issues

<AccordionGroup>
  <Accordion title="Sandbox not starting">
    * Wait up to 30 seconds — sandbox startup can take time
    * Refresh the page and try again
    * Check if you have an active subscription or credits remaining
  </Accordion>

  <Accordion title="Preview shows blank or white screen">
    * Open Sandbox Panel → Vite Logs to check for build errors
    * The AI may have introduced a syntax error — ask it to fix: "The page is blank, please fix any errors"
    * Try clicking "Restart" in the terminal
  </Accordion>

  <Accordion title="Changes not appearing in preview">
    * Hot-reload usually handles this automatically
    * If stuck, ask the AI: "Restart the dev server"
    * Open Terminal and run the restart command
  </Accordion>

  <Accordion title="Sandbox crashes repeatedly">
    * The auto-recovery system restarts crashed sandboxes
    * If it keeps crashing, the code might have an infinite loop — ask AI to review and fix
    * Check Vite Logs for out-of-memory errors
  </Accordion>
</AccordionGroup>

## Deployment issues

<AccordionGroup>
  <Accordion title="Deployment fails">
    * Check the error message in the Deploy panel
    * Common cause: build errors in your code — fix them through AI chat first
    * Try deploying again after fixing issues
  </Accordion>

  <Accordion title="Deployed app doesn't work correctly">
    * Check that your app works in the preview first
    * Some features requiring server-side logic may not work in static deployments
    * Ensure all API URLs are using production endpoints
  </Accordion>
</AccordionGroup>

## Account & billing

<AccordionGroup>
  <Accordion title="Credits not refreshing">
    * Monthly credits reset on your billing date
    * Check Account Settings → Credits Information for your reset date
    * Extra purchased credits don't expire or reset
  </Accordion>

  <Accordion title="Can't log in">
    * Try resetting your password via the login page
    * Clear browser cookies and try again
    * Make sure you're using the same login method (email, Google, etc.) you signed up with
  </Accordion>

  <Accordion title="Subscription not updating">
    * Payment processing can take a few minutes
    * Refresh the page after completing checkout
    * Contact support at [info@seemodo.ai](mailto:info@seemodo.ai) if the issue persists
  </Accordion>
</AccordionGroup>

## GitHub integration

<AccordionGroup>
  <Accordion title="Can't connect to GitHub">
    * Make sure you've authorized Seemodo on GitHub
    * Check that you have the right permissions for the target organization
    * Try disconnecting and reconnecting
  </Accordion>

  <Accordion title="Push/Pull fails">
    * Check if there are merge conflicts
    * Ensure the target branch exists
    * Verify your GitHub token hasn't expired
  </Accordion>
</AccordionGroup>

## Seemodo Cloud

<AccordionGroup>
  <Accordion title="Cloud activation fails">
    * Ensure you have an active sandbox running first
    * Try closing and reopening the Cloud modal
    * Check your internet connection
  </Accordion>

  <Accordion title="Database queries not working">
    * Verify Seemodo Cloud is activated (cloud icon should be active)
    * Check the SQL syntax in the database manager
    * Ask the AI to debug: "The database query for users isn't working"
  </Accordion>
</AccordionGroup>

## Still need help?

Contact us at **[info@seemodo.ai](mailto:info@seemodo.ai)** or visit our [website](https://seemodo.ai) for more support options.