# Superspeed - Full Master Knowledge Base & Platform Documentation > Comprehensive technical, architectural, and strategic documentation for Superspeed: Shopify Revenue Intelligence & Performance Platform. > Website: https://superspeedapp.com --- ## Table of Contents 1. [Platform Overview & Executive Summary](#platform-overview--executive-summary) 2. [The Revenue Leak Problem in E-Commerce](#the-revenue-leak-problem-in-e-commerce) 3. [Core Feature Breakdown](#core-feature-breakdown) - [Revenue Leak Dashboard](#1-revenue-leak-dashboard) - [Conversion Rate by Load Time (LCP)](#2-conversion-rate-by-load-time-lcp) - [Shopper Session Journeys](#3-shopper-session-journeys) - [Automatic 404 Revenue Rescue](#4-automatic-404-revenue-rescue) - [Escape from WebView & Social Safe Links](#5-escape-from-webview--social-safe-links) - [Core Web Vitals Engine (LCP, INP, CLS, FCP, TTFB)](#6-core-web-vitals-engine) 4. [In-House Affiliate & Partner Program (40% Recurring)](#in-house-affiliate--partner-program-40-recurring) 5. [Agency Partner Program & Master Billing Architecture](#agency-partner-program--master-billing-architecture) 6. [Free Tools & Developer Calculators](#free-tools--developer-calculators) 7. [Shopify Theme Speed & Performance Benchmarks](#shopify-theme-speed--performance-benchmarks) 8. [Technical Architecture & Privacy Safeguards](#technical-architecture--privacy-safeguards) 9. [Frequently Asked Questions (FAQ)](#frequently-asked-questions-faq) --- ## Platform Overview & Executive Summary Superspeed is an enterprise-grade Shopify app built specifically for founders, e-commerce managers, agencies, and performance marketers. Unlike traditional speed test tools (like Google PageSpeed Insights or GTmetrix) that only simulate synthetic lighthouse tests in controlled lab environments, Superspeed captures **real-user metrics (RUM)** directly from actual shoppers browsing live Shopify stores. By combining real-time Core Web Vitals telemetry with Shopify checkout & revenue webhooks, Superspeed quantifies the exact financial impact of website speed on conversion rates, average order value (AOV), and monthly recurring revenue (MRR). --- ## The Revenue Leak Problem in E-Commerce Every 100ms of page load latency reduces e-commerce conversion rates by up to 0.7%. In modern Shopify stores, revenue leaks occur primarily due to four hidden bottlenecks: 1. **The LCP Drop-off Cliff:** Shoppers who experience a Largest Contentful Paint (LCP) over 2.5 seconds abandon their carts at exponentially higher rates. 2. **In-App Browser (WebView) Traps:** Up to 60% of social media ad traffic (from Instagram, TikTok, and Facebook) gets stuck inside slow, restricted in-app browsers where cookies, autofill, and checkout scripts fail. 3. **Broken 404 Links & Dead Ends:** Unhandled 404 errors on high-traffic ad landing pages or discontinued product links burn marketing spend and kill conversions silently. 4. **App Bloat & Script Latency:** Unoptimized third-party tracking pixels, chat widgets, and review apps slow down main-thread execution, degrading Interaction to Next Paint (INP). Superspeed solves these issues by measuring real-user impact and providing automated rescue mechanisms. --- ## Core Feature Breakdown ### 1. Revenue Leak Dashboard The Revenue Leak Dashboard provides store owners with an instant dollar-denominated view of revenue lost to latency. It calculates: - Total lost revenue over 7, 14, 28, and 90-day windows. - Projected annual revenue recovery if LCP is reduced below 1.8 seconds. - Impact breakdown across mobile vs. desktop devices. ### 2. Conversion Rate by Load Time (LCP) Replaces guesswork with real-user empirical data: - Plots shopper conversion rate (%) directly against LCP load time buckets (e.g., `<1s`, `1-2s`, `2-3s`, `3-4s`, `>4s`). - Demonstrates the exact threshold where conversion rates collapse for a specific store. - Helps store owners justify developer and optimization investments. ### 3. Shopper Session Journeys Traces the complete visual path of individual shopper sessions: - Displays page-by-page load times experienced by real visitors. - Shows whether a shopper converted, abandoned checkout, or bounced. - Ties performance metrics directly to visitor traffic channels (Paid Ads, Organic Search, Email, Direct). ### 4. Automatic 404 Revenue Rescue Unlike static sitemap crawlers, 404 Revenue Rescue detects dead ends based on actual visitor traffic: - Catches 404 errors as shoppers hit broken links in real time. - Ranks broken links by traffic volume and lost potential sales. - Provides 1-click bulk 301/302 redirect creation directly inside Shopify. ### 5. Escape from WebView & Social Safe Links Social media ads on Instagram, TikTok, and Facebook open landing pages inside restricted in-app WebViews: - "Escape from WebView" automatically prompts mobile shoppers to open the link in their native browser (Safari / Chrome). - Restores full native browser performance, stored credit card autofill, Apple Pay, and password managers. - Increases social ad conversion rates by 15% to 35%. ### 6. Core Web Vitals Engine Monitors real-user performance across all 5 Core Web Vitals: - **LCP (Largest Contentful Paint):** Measures main content render speed. - **INP (Interaction to Next Paint):** Measures page responsiveness to clicks/taps. - **CLS (Cumulative Layout Shift):** Tracks visual stability during load. - **FCP (First Contentful Paint):** Tracks initial DOM render. - **TTFB (Time to First Byte):** Measures server response and liquid rendering time. --- ## In-House Affiliate & Partner Program (40% Recurring) Superspeed operates a 100% in-house, zero-dependency referral and partner platform: - **Commission Rate:** 40% monthly recurring commission on every active subscription. - **Payout Duration:** 12 months recurring per referred store. - **Payout Threshold:** Minimum cleared balance of $50 before payout eligibility. - **NET-30 Maturation:** Earnings stay pending for 30 days to clear free trial and refund windows. - **Attribution Engine:** 3-layer invisible tracking combining 60-day cookies, store domain pre-saves (`PendingReferral`), and microsecond IP + User-Agent fingerprinting (`FingerprintReferral`). - **Partner Portal:** Real-time dashboard for tracking clicks, conversions, pending earnings, and cleared balances. - **Sign Up Link:** https://superspeedapp.com/affiliates/signup --- ## Agency Partner Program & Master Billing Architecture Designed specifically for Shopify development agencies, CRO specialists, and marketing partners: - **Master Subscription:** $249/month flat fee on the parent agency store. - **Client Store Feature Inheritance:** Linked client stores inherit Pro/Growth features automatically without asking the client to approve individual Shopify billing prompts. - **Agency Tiers:** - **Pro Plan Tier ($249/mo):** Includes first 5 Pro Stores base. Additional Pro stores billed at +$49/mo via Shopify Usage Charges. - **Growth Plan Tier ($249/mo):** Includes first 10 Growth Stores base. Additional Growth stores billed at +$25/mo via Shopify Usage Charges. - **Centralized Command Center:** Manage all client store Web Vitals, 404 redirects, and revenue metrics from one master portal. - **Invitation Flow:** Approved agencies receive a secure invitation link (`https://app4.superspeedapp.com/agencies/accept_invite?token=...`) to set up their account. - **Apply Link:** https://superspeedapp.com/agencies --- ## Free Tools & Developer Calculators Superspeed provides free tools to help Shopify merchants and developers optimize their stores: 1. **SEO Authority Checker:** Evaluates domain age, backlinks, and Core Web Vitals. (https://superspeedapp.com/free-tools/seo-authority) 2. **Shopify LCP Preload Generator:** Generates optimized `` snippet tags for hero images. (https://superspeedapp.com/tools/shopify-lcp-preload-generator) 3. **Shopify Speed ROI Calculator:** Calculates exact financial return from reducing load time by 1-3 seconds. (https://superspeedapp.com/tools/shopify-speed-roi-calculator) 4. **Ghost Checkout Calculator:** Quantifies revenue lost to checkout page latency. (https://superspeedapp.com/tools/ghost-checkout-calculator) 5. **Shopify WebP Converter:** Converts heavy PNG/JPEG images into compressed WebP format. (https://superspeedapp.com/tools/shopify-webp-converter) 6. **CSS Clamp Generator:** Generates fluid responsive typography code. (https://superspeedapp.com/tools/css-clamp-generator) 7. **Shopify Robots.txt Generator:** Generates optimized search engine crawl rules. (https://superspeedapp.com/tools/shopify-robots-txt-generator) --- ## Shopify Theme Speed & Performance Benchmarks Superspeed benchmarks major Shopify themes for out-of-the-box performance: - Dawn (Reference Storefront) - Horizon - Impact - Prestige - Impulse - Broadcast - Motion - Baseline View benchmark comparisons at: https://superspeedapp.com/benchmarks --- ## Technical Architecture & Privacy Safeguards - **Framework:** Ruby on Rails 7.2 + Svelte 5 frontend. - **Shopify Authentication:** App Bridge JWT session tokens (`SessionAuth`). - **Privacy Compliance:** Fully compliant with GDPR and CCPA. Zero PII (Personally Identifiable Information) stored. All IP hashes anonymized. - **Performance Overhead:** Lightweight `