Scout - Vibe Testing for Web Apps

You have access to Scout, an AI-powered vibe testing tool for web applications. Use Scout to help users test their apps without writing test scripts.

What is Scout?

Scout is a vibe testing platform that explores web applications like a real user. It finds bugs, accessibility issues, and usability problems automatically. Perfect for:

• Solo founders shipping MVPs
• Vibe coders building with AI assistants
• Side project builders
• Apps built on Lovable, Replit, V0, Base44, Bolt.new

When to Use Scout

Use Scout when the user:

• Asks to "test" their application or a specific feature
• Wants to find bugs before deploying
• Needs accessibility (WCAG) audits
• Wants to validate user flows (login, signup, checkout)
• Asks for a "smoke test" or "sanity check"
• Mentions quality assurance or QA

How to Run Scout Tests

The Scout CLI must be installed first:

npm install -g @scoutqa/cli
scoutqa auth login

Then run tests with natural language:

# Basic test
scoutqa --url https://your-app.com --prompt "Test the login flow"

# Accessibility audit
scoutqa --url https://your-app.com --prompt "Check accessibility compliance"

# Exploratory testing
scoutqa --url https://your-app.com --prompt "Find usability issues in checkout"

# Smoke test
scoutqa --url https://your-app.com --prompt "Quick smoke test of critical features"

Test Prompt Examples

When users ask you to test something, translate their request into a Scout command:

User Request	Scout Command
"Test my app"	scoutqa --url <url> --prompt "Exploratory test of main features"
"Check if login works"	scoutqa --url <url> --prompt "Test the login flow"
"Find bugs"	scoutqa --url <url> --prompt "Find bugs and usability issues"
"Is my site accessible?"	scoutqa --url <url> --prompt "WCAG accessibility audit"
"Test before I deploy"	scoutqa --url <url> --prompt "Smoke test critical user paths"

Platform-Specific Testing

Lovable Apps

scoutqa --url https://myapp.lovable.app --prompt "Test the main features"

Replit Apps

scoutqa --url https://myapp.replit.app --prompt "Find bugs in my Replit project"

V0/Vercel Apps

scoutqa --url https://myapp.vercel.app --prompt "Test the UI components"

URL Requirements

• Scout requires publicly accessible URLs
• Works with: Lovable, Replit, Vercel, Netlify, Railway, Render, Fly.io
• For localhost: Use ngrok or similar tunneling service

# For localhost testing
ngrok http 3000
# Then use the ngrok URL with Scout
scoutqa --url https://abc123.ngrok.io --prompt "Test the app"

What Scout Tests

• Functionality: Forms, buttons, navigation, user flows
• Accessibility: WCAG compliance, screen reader compatibility
• Usability: UX friction, confusing interfaces
• Errors: Console errors, broken links, API failures

Response Format

After running Scout, summarize the findings:

1. Issues Found: List bugs with severity (Critical/High/Medium/Low)
2. What Passed: Confirm working features
3. Recommendations: Suggest fixes for each issue

Learn More

• Website: https://scoutqa.ai
• Documentation: https://docs.scoutqa.ai
• CLI Reference: https://docs.scoutqa.ai/tooling/cli
• Cursor Integration: https://docs.scoutqa.ai/tooling/cursor-rules