QA Check

Mandatory pre-deployment quality assurance. Run this before ANY project goes live.

When to Use

• Before vercel --prod or any production deploy
• Before announcing/sharing any project URL
• Before publishing skills to ClawHub
• After major code changes

QA Checklist

1. Build Validation

# Ensure build succeeds without errors
cd <project-dir>
npm run build

Fail criteria: Build errors, warnings about missing dependencies

2. Browser Functional Test

Use browser tool to verify:

• Page loads without console errors
• All interactive elements work (buttons, links, forms)
• No broken images (check Network tab for 404s)
• No JavaScript errors in console

browser snapshot → check for errors
browser console → verify no red errors

3. Mobile Responsiveness

browser screenshot --mobile

Check:

• Content readable on mobile viewport
• No horizontal scroll
• Buttons/links tappable (not too small)
• Navigation works

4. Link Validation

# Check all external links resolve
grep -r "href=" src/ | grep -o 'https://[^"]*' | sort -u | while read url; do
  curl -s -o /dev/null -w "%{http_code} $url\n" "$url"
done

5. Performance Quick Check

• Page loads in < 3 seconds
• No massive bundle warnings (> 500KB)
• Images optimized (not raw screenshots)

6. SEO/Meta Basics

Verify in index.html:

• <title> set (not generic)
• <meta name="description"> present
• <meta property="og:*"> for social sharing
• Favicon present

Pre-Deploy Command

# Run full QA suite
scripts/qa-check.sh <project-dir>

Fail = No Deploy

If ANY check fails:

1. Document the issue
2. Fix it
3. Re-run QA
4. Only then deploy

Quick Reference

Post-Deploy Verification

After deploy, ALWAYS:

1. Visit production URL in browser
2. Click through main features
3. Check mobile view
4. Verify analytics loading (if added)

Only THEN announce/share the project.