Skip to content

alexCevi/shopify-store-eval

Repository files navigation

Shopify Storefront Snapshot Chrome Extension

A Chrome extension that audits Shopify storefronts and surfaces catalog metrics, pricing intelligence, detected tooling, merchandising patterns, and prioritized opportunities in a single side-panel view.

Shopify Storefront Snapshot

Features

  • Structured Storefront Audit — Overall score, maturity verdict, confidence score, and theme summary
  • Catalog Diagnostics — Product count, variant depth, SKU coverage, availability rate, and price spread
  • Pricing Intelligence — Min, max, quartiles, median, estimated AOV, discount coverage, and shipping threshold detection
  • Pattern Detection — Bundle, subscription, urgency, installment, upsell, social proof, guided selling, and lead-capture patterns
  • Detected Stack — Loyalty programs, quizzes, wishlists, reviews, pixels, affiliates, ESPs, SMS, popups, and shipping offers
  • Actionable Recommendations — Strengths, gaps, and suggested moves for merchandising, conversion, AOV, retention, and trust

This workspace contains a complete MV3 extension that uses background scanning logic to fetch catalog data, infer storefront signals from the active page, and transform that into a more opinionated evaluation model.

Documentation

  • Signal Collection and Determination — How signals are collected from page markup and text, which patterns are used for detection, and how signals drive evaluation scorecards, patterns, and findings.

Files

  • manifest.json
    • Declares service worker, content script, permissions, and popup.
  • background.js
    • Core scan flow with fetch + retry, pagination, catalog metrics, shipping detection, signal summarization, evaluation scorecards, findings, opportunities, caching, and message passing.
  • content.js
    • Collects page text, script content, canonical domain hints, and popup shipping hints from the current tab.
  • popup.html, popup.css, popup.js
    • Side-panel UI for running audits and presenting scorecards, findings, opportunities, catalog stats, price architecture, and detected stack details.

Load in Chrome

  1. Open chrome://extensions
  2. Enable Developer mode
  3. Click Load unpacked
  4. Select this directory
  5. Reload the extension after this change
  6. Open a Shopify storefront tab and click the extension icon
  7. The snapshot UI now opens in Chrome's side panel (requires Chrome support for Side Panel API)

Notes

  • Output is cached per domain in chrome.storage.local.
  • If a canonical domain cannot be extracted from page hints, the extension falls back to endpoint detection and then current domain.
  • All scan messages pass through chrome.runtime message handlers in the service worker.
  • Evaluation output is heuristic, not authoritative. It is intended to speed up qualitative review of storefront maturity and merchandising patterns.

About

A Chrome extension that scans Shopify storefronts and surfaces catalog metrics, pricing intelligence, and marketing signals in a single side-panel view.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors