From c8dc0dabcef17eae3fedf79bfd04fdf351c97700 Mon Sep 17 00:00:00 2001 From: Venkata Anil Kumar Date: Fri, 17 Apr 2026 15:04:54 -0400 Subject: [PATCH] chore: improve public README and add social preview spec --- README.md | 62 +++++++++++++++- .../Qvora_GitHub-Social-Preview-Spec.md | 73 +++++++++++++++++++ 2 files changed, 131 insertions(+), 4 deletions(-) create mode 100644 docs/01-brand/Qvora_GitHub-Social-Preview-Spec.md diff --git a/README.md b/README.md index c69ad9a..7e571f5 100644 --- a/README.md +++ b/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 diff --git a/docs/01-brand/Qvora_GitHub-Social-Preview-Spec.md b/docs/01-brand/Qvora_GitHub-Social-Preview-Spec.md new file mode 100644 index 0000000..23c1b43 --- /dev/null +++ b/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.