FirstQA Documentation

Complete guide to using the only QA stack your startup needs - Ovi AI + Human QA Experts.

1. What is FirstQA?

FirstQA is a comprehensive QA platform that combines AI-powered analysis with on-demand human QA expertise. Our platform offers instant PR feedback through Ovi AI and connects you with expert QA engineers for complex testing scenarios.

2. How It Works

1. 🔗 Connect Your Tools: Integrate with GitHub, Linear, and Jira
2. 🤖 AI Analysis: Instant expert review of tickets and PRs
3. 📊 Get Feedback: Instant QA insights and test recipes
4. 👥 Human QA: On-demand senior QA when it really matters

3. Getting Started

1. Install the GitHub App: Install FirstQA on your repository. You can choose which repos to enable it for.
2. Open a Pull Request: Create or update a PR in your enabled repository.
3. Automatic Analysis: Ovi AI automatically analyzes your PR and provides instant feedback.
4. Request Human QA: Add a comment with /test for comprehensive manual testing.

4. Ovi AI - Your AI QA Agent

Ovi AI provides instant, comprehensive QA analysis for every PR:

What Ovi Analyzes

• 🔍 Change Review: Analyzes PR metadata, identifies ambiguity, generates smart questions
• 🧪 Test Recipe: Creates comprehensive test scenarios and automation plans
• 📊 Code Quality: Identifies affected modules, test coverage gaps, and improvements
• ⚠️ Risk Assessment: Provides production readiness score (1-10) with business focus

Production Readiness Scoring

5. Requesting Human QA Testing

To request comprehensive manual QA testing, add a comment to your PR that starts with /test. You can include details about what you want tested, browsers/devices, and any special requirements.

/test

Please run a full manual QA on this PR. Here's what I'd like you to focus on:
- Main goal: Verify the new user onboarding flow (sign up, email verification, and first login).
- Browsers: Chrome (latest), Firefox (latest), Safari (latest).
- Devices: Desktop and mobile (iPhone 13, Pixel 6).
- Test data: Use test email addresses (e.g., test+onboarding1@myapp.com).
- What to look for:
  - Any blockers or bugs in the onboarding steps
  - Usability issues or confusing UI
  - Broken links, typos, or missing error messages
  - Accessibility issues (keyboard navigation, screen reader basics)
  - Edge cases (weak passwords, invalid emails, slow network)
- Environment: https://staging.myapp.com
- Test user: testuser / password: Test1234!

6. What Happens Next?

1. Your test request is received by our expert QA team.
2. Testing usually begins within 4 hours (often much faster).
3. You'll receive comments in your PR with bug reports, usability feedback, and a final test report.

7. Understanding Reports

Bug reports and test reports are posted as comments in your PR. Here's what they look like:

### 🐞 Bug Report

Summary:
After submitting the sign-up form with a valid email and password, the app shows a "Something went wrong" error and does not create the account.

Steps to Reproduce:
1. Go to https://staging.myapp.com/signup
2. Enter a valid email and password
3. Click "Sign Up"
4. Observe the error message

Expected Result:
User account should be created and redirected to the email verification page.

Actual Result:
An error message appears: "Something went wrong. Please try again later." No account is created.

### ✅ Final Test Report

Scope:
- Full manual QA of the new user onboarding flow
- Browsers: Chrome, Firefox, Safari (latest)
- Devices: Desktop (Mac, Windows), Mobile (iPhone 13, Pixel 6)

Summary:
All critical and high-priority issues have been fixed. The onboarding flow now works smoothly across all tested browsers and devices.

Results:
- No blockers or major bugs found
- Minor UI issues from previous round have been fixed
- Usability is good, error messages are clear
- Accessibility is improved (labels, focus order)

Recommendation:
Ready to merge! 🚀

8. Pricing & Plans

FirstQA offers AI-powered QA with optional human validation:

9. Frequently Asked Questions (FAQ)

10. Need Help or Have Questions?

If you have questions, want to give feedback, or need support, you can:

• Contact us via the Contact form
• Schedule a demo call
• Email us at support@firstqa.dev
• Visit our Support page