chore: improve public README and add social preview spec

README.md

@@ -4,6 +4,20 @@
 
 **Paste a URL. Get 10 video ads. Know which ones win — automatically.**
 
+[Star Qvora on GitHub](https://github.com/VenkataAnilKumar/Qvora) if you find this project useful.
+
+## Demo And Snapshot
+
+- Product: AI-powered performance creative SaaS for agencies
+- Core flow: URL -> AI brief -> video variants -> performance signals -> better variants
+- Format output: short-form 9:16 ads for paid social
+
+## Why Qvora
+
+- Ship more ad variants faster without manual editing bottlenecks
+- Keep creative strategy grounded in measurable performance signals
+- Run agency workflows with multi-tenant workspace boundaries
+
 Qvora is an AI-powered performance creative platform for agencies. It turns any product URL into a full batch of short-form video ads (9:16), then uses real performance signals to generate better-performing variants in the next round. No briefs to write. No editors to brief. No guesswork.
 
 ---
@@ -216,11 +230,51 @@ cd src/services/worker && go build ./...
 
 ## Repository
 
-This repository is private and internal. All planning, architecture, and implementation details are confidential. Do not publish externally without explicit approval.
+This repository is public for product visibility and collaboration. Keep secrets out of source control and use Doppler or environment variables for sensitive configuration.
 
 **License:** Proprietary. All rights reserved.
 
-- Badge test: YOLO flow (2026-04-17)
-- Badge test: Pair flow (2026-04-17)
+---
+
+## Social Preview Checklist
+
+Use this before sharing Qvora publicly to improve discovery and conversions.
+
+- Add a social preview image at 1280x640 in repository settings
+- Keep title consistent: Qvora - Born to Convert
+- Keep description aligned with the repo description and README hero
+- Pin this repository on your GitHub profile
+- Add website/homepage URL if available
+- Verify topics are set: ai, generative-ai, saas, adtech, video-generation, nextjs, golang, rust, supabase, vercel
+- Keep README top section focused on value, proof, and clear CTA
+
+## Launch Copy (Ready To Post)
+
+### X / Twitter
+
+Building in public: Qvora is now live on GitHub.
+
+Qvora turns a product URL into short-form video ads, then improves variants using performance signals.
+
+If this is useful for your agency workflow, star the repo:
+https://github.com/VenkataAnilKumar/Qvora
+
+### LinkedIn
+
+I just made Qvora public on GitHub.
+
+Qvora is an AI-powered performance creative platform for agencies: paste a product URL, generate short-form video ad variants, and use performance signals to improve the next round.
+
+Repository:
+https://github.com/VenkataAnilKumar/Qvora
+
+If this direction is interesting to you, a star or feedback is appreciated.
+
+### Product / Community Short Blurb
+
+Qvora helps agencies go from URL to performance creative faster:
+- AI-generated angles, hooks, and scripts
+- Multi-model video generation pipeline
+- Signal-informed creative iteration loop
 
-- Badge test: YOLO retry flow (2026-04-17)
+Repo: https://github.com/VenkataAnilKumar/Qvora

docs/01-brand/Qvora_GitHub-Social-Preview-Spec.md

@@ -0,0 +1,73 @@
+# Qvora GitHub Social Preview Spec
+
+This spec defines the Open Graph social preview image for the repository settings page.
+
+## Goal
+
+Increase click-through and star conversion when the repository is shared on GitHub, X, LinkedIn, and chat previews.
+
+## Canvas
+
+- Size: 1280 x 640 px
+- Aspect ratio: 2:1
+- Safe margin: 64 px on all sides
+- Format: PNG
+- Max file size target: under 1 MB
+
+## Visual Direction
+
+- Style: dark, high-contrast, performance-focused
+- Background: deep charcoal with subtle gradient and soft noise texture
+- Accent colors:
+  - Volt: #7B2FFF
+  - Convert Green: #00E87A
+  - Data Blue: #2E9CFF
+  - Signal Red: #FF3D3D
+- Typography:
+  - Headline: Clash Display or Space Grotesk Bold
+  - Supporting text: Inter
+
+## Layout
+
+1. Top-left: Qvora wordmark or text lockup
+2. Center-left headline: short and bold
+3. Center-left subhead: one-sentence value proposition
+4. Bottom-left CTA text: star + repository URL
+5. Right side: abstract performance bars, ad frame, or creative card stack illustration
+
+## Copy Variants
+
+Choose one headline and one subhead.
+
+### Headline options
+
+- Born to Convert.
+- URL to Winning Ads.
+- From Product Page to Paid Social Creative.
+
+### Subhead options
+
+- Paste a URL. Generate short-form ads. Improve with performance signals.
+- AI-powered creative engine for agencies running paid social.
+- Build ad variants faster and iterate from real performance data.
+
+### CTA line
+
+- Star the repo: github.com/VenkataAnilKumar/Qvora
+
+## Export Checklist
+
+- Verify text remains readable at small preview size
+- Ensure no critical text is inside the outer 64 px margin
+- Keep contrast ratio high for headline and CTA
+- Export as PNG and upload in repository social preview settings
+- Test appearance on GitHub link previews and X post previews
+
+## Optional A/B Test Plan
+
+Create two versions and track 14-day star growth:
+
+- Version A: product-value headline (URL to Winning Ads)
+- Version B: brand-led headline (Born to Convert.)
+
+Pick the version with higher star conversion from profile and social traffic.