Skip to content

docs: Add comprehensive Troubleshooting guide#6

Open
vishaldubey01 wants to merge 1 commit intomainfrom
dev/add-troubleshooting-guide
Open

docs: Add comprehensive Troubleshooting guide#6
vishaldubey01 wants to merge 1 commit intomainfrom
dev/add-troubleshooting-guide

Conversation

@vishaldubey01
Copy link

@vishaldubey01 vishaldubey01 commented Mar 6, 2026

What

Adds a new Troubleshooting page to the Vibecode docs, covering the most common issues users run into.

Sections

  • Building & Prompting — Blank screens, agent going in circles, preview differences, package issues, performance
  • Deployment — Failed deploys, dev vs production differences, custom domain DNS issues
  • Backend & Database — API failures, auth/lockout problems, database tab not loading
  • App Store & Distribution — Common rejection reasons, sharing link issues
  • Account & Billing — Credit usage, payment processing delays
  • General Tips — Quick reference cards for common best practices

Navigation

Added a "Help" group under the Resources tab containing the troubleshooting page.

Related

  • Partially addresses ENG-697 (docs improvements)
  • Complements ENG-736 (onboarding and support guide)

Note

Low Risk
Docs-only changes (new MDX page + navigation entry) with no runtime or security impact beyond potential broken links/rendering if misconfigured.

Overview
Adds a new troubleshooting.mdx page that compiles common fixes across building/prompting, deployment, backend/database, app store/distribution, and billing issues, with actionable checklists and support links.

Updates docs.json navigation by adding a new Help group under the Resources tab that exposes the troubleshooting page.

Written by Cursor Bugbot for commit ede8045. This will update automatically on new commits. Configure here.

Adds a comprehensive troubleshooting page covering:
- Building & prompting issues (blank screens, agent loops, preview differences, package problems, performance)
- Deployment issues (failed deploys, dev vs production differences, custom domains)
- Backend & database issues (API failures, auth problems, database tab loading)
- App Store & distribution (rejection reasons, sharing link issues)
- Account & billing (credits, payment processing)

Also adds a 'Help' group in the Resources tab navigation.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant