> ## Documentation Index
> Fetch the complete documentation index at: https://vlyai-1c28d863.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> When something's not working, start here. Common errors, debugging workflows, when to contact support.

When something's broken, the fastest path to a fix:

<Steps>
  <Step title="Check [common errors](/troubleshooting/common-errors)">
    90% of issues are one of a few patterns.
  </Step>

  <Step title="Check vly's [status page](https://status.vly.ai)">
    If it's an outage, you'll see it here.
  </Step>

  <Step title="Search the [FAQ](/getting-started/faq)">
    Specific questions are often already answered.
  </Step>

  <Step title="Use the [debugging workflow](/troubleshooting/debugging-workflow)">
    Systematic approach for "I don't know what's wrong" cases.
  </Step>

  <Step title="Ask in [Discord](https://discord.gg/vly) or email [support](mailto:support@vly.ai)">
    If it's still not resolved, we'll help.
  </Step>
</Steps>

## Common categories

<CardGroup cols={2}>
  <Card title="Common errors" icon="alert-triangle" href="/troubleshooting/common-errors">
    Auth errors, type errors, build failures with familiar patterns.
  </Card>

  <Card title="Build failures" icon="x-circle" href="/troubleshooting/build-failures">
    When the type-checker rejects the build.
  </Card>

  <Card title="Deployment issues" icon="cloud" href="/troubleshooting/deployment-issues">
    DNS, SSL, custom domain problems.
  </Card>

  <Card title="Integration problems" icon="puzzle" href="/troubleshooting/integration-problems">
    Stripe webhooks not firing, OAuth redirects failing, Resend emails bouncing.
  </Card>

  <Card title="Performance issues" icon="gauge" href="/troubleshooting/performance-issues">
    Slow queries, slow page loads, slow agent responses.
  </Card>

  <Card title="Debugging workflow" icon="bug" href="/troubleshooting/debugging-workflow">
    The systematic approach when you don't know where to start.
  </Card>
</CardGroup>

## Getting help

<CardGroup cols={3}>
  <Card title="Community Discord" icon="message-circle" href="https://discord.gg/vly">
    Live chat with the team and other vly users.
  </Card>

  <Card title="Email support" icon="mail" href="mailto:support@vly.ai">
    For non-urgent technical issues.
  </Card>

  <Card title="Escalation" icon="phone" href="/troubleshooting/escalation">
    For Business+ tiers with urgent issues.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.