/check-virality

Audit viral growth infrastructure. Output findings as structured report.

What This Does

• Check social metadata (OG tags, Twitter cards)

• Check dynamic OG image generation

• Check share mechanics

• Check referral system

• Check distribution readiness

• Output prioritized findings (P0-P3)

This is a primitive. It only investigates and reports. Use /log-virality-issues to create GitHub issues or /fix-virality to fix.

Process

1. Social Metadata Check

OG tags present?

grep -rE "og:title|og:description|og:image" --include=".tsx" --include=".ts" app/ src/ pages/ 2>/dev/null | head -5

Twitter cards?

grep -rE "twitter:card|twitter:title|twitter:image" --include=".tsx" --include=".ts" app/ src/ pages/ 2>/dev/null | head -5

Root metadata?

grep -q "generateMetadata|metadata.*:" app/layout.tsx 2>/dev/null && echo "✓ Root metadata" || echo "✗ Root metadata missing"

2. Dynamic OG Images Check

OG image endpoint?

[ -f "app/api/og/route.tsx" ] || [ -d "pages/api/og" ] && echo "✓ OG image endpoint" || echo "✗ OG image endpoint"

Using @vercel/og?

grep -q "@vercel/og" package.json 2>/dev/null && echo "✓ @vercel/og installed" || echo "✗ @vercel/og not installed"

Dynamic images per content type?

grep -rE "generateMetadata.images" --include=".tsx" app/ 2>/dev/null | head -5

3. Share Mechanics Check

Share components?

grep -rE "share|Share|navigator.share" --include=".tsx" --include=".ts" components/ src/ 2>/dev/null | head -5

Shareable URLs?

grep -rE "shareUrl|shareLink|getShareUrl|clipboard.writeText" --include=".tsx" --include=".ts" . 2>/dev/null | grep -v node_modules | head -5

Web Share API?

grep -q "navigator.share" components/**/*.tsx 2>/dev/null && echo "✓ Web Share API" || echo "✗ Web Share API"

4. Referral System Check

Referral codes?

grep -rE "referral|invite|inviteCode|refCode" --include=".tsx" --include=".ts" --include="*.sql" . 2>/dev/null | grep -v node_modules | head -5

Attribution tracking?

grep -rE "utm_|referrer|attribution" --include=".tsx" --include=".ts" . 2>/dev/null | grep -v node_modules | head -5

Referral tracking in database?

grep -rE "referral|invitation" --include="*.ts" convex/ schema/ prisma/ 2>/dev/null | head -5

5. Distribution Readiness Check

Launch assets?

[ -f "public/product-hunt-logo.png" ] || [ -d "public/launch" ] && echo "✓ Launch assets" || echo "✗ Launch assets"

Press kit?

[ -d "public/press" ] || [ -d "public/media" ] && echo "✓ Press kit" || echo "✗ Press kit"

Changelog page?

[ -f "app/changelog/page.tsx" ] || [ -f "pages/changelog.tsx" ] && echo "✓ Changelog page" || echo "✗ Changelog page"

Social proof?

grep -rE "testimonial|review|rating" --include="*.tsx" . 2>/dev/null | grep -v node_modules | head -3

6. Viral Loop Analysis

Check for viral loop patterns:

• Creation → Share prompts

• Achievement → Share cards

• Invitation → Reward system

• Content → Watermarks/branding

Output Format

Virality Audit

P0: Critical (Invisible Online)

• No OG tags - Links look broken when shared
• No root metadata configured

P1: Essential (Every Product)

• No dynamic OG images - All shares look the same
• No share button/mechanism
• No Twitter card configuration
• metadataBase not set (og images won't work)

P2: Important (Growth)

• No referral system
• No attribution (UTM) tracking
• No share prompts at key moments
• No Web Share API (mobile native share)

P3: Launch Readiness

• No changelog page
• No press kit
• No launch assets
• No testimonials/social proof

Current Status

• OG metadata: Missing
• Dynamic OG images: Not configured
• Share mechanics: None
• Referral system: None
• Distribution: Not ready

Summary

• P0: 2 | P1: 4 | P2: 4 | P3: 4
• Recommendation: Add root metadata and OG image endpoint first

Priority Mapping

Gap Priority

No OG tags P0

No root metadata P0

No dynamic OG images P1

No share mechanics P1

No Twitter cards P1

No referral system P2

No UTM tracking P2

No share prompts P2

Launch assets missing P3

No changelog P3

Related

• /log-virality-issues

• Create GitHub issues from findings

• /fix-virality

• Fix virality gaps

• /virality

• Full viral growth workflow

• /launch-strategy

• Product launch planning