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#

bash

# 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

text

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

3. Mobile Responsiveness#

text

browser screenshot --mobile

Check:

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

4. Link Validation#

bash

# 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#

bash

# 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#

CheckToolPass CriteriaBuildnpm run buildExit 0, no errorsBrowserbrowser snapshotNo console errorsMobilebrowser screenshotReadable, no scrollLinkscurlAll 200/301SpeedBrowser< 3s loadSEORead index.htmlAll meta present

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.