# Live Product Insights

> Live product activity and sales insights for Shopify — real counts, honest metrics, no fake scarcity.

- [Installation](https://topten.mintlify.app/getting-started/installation.md): Install Live Product Insights on your Shopify store and understand the permissions it requests.
- [Theme setup](https://topten.mintlify.app/getting-started/theme-setup.md): Enable the tracker app embed and add the Live View Counter to your product template so data starts flowing.
- [First data](https://topten.mintlify.app/getting-started/first-data.md): When each kind of data appears after setup, and what to check if nothing shows up.
- [Dashboard](https://topten.mintlify.app/guides/dashboard.md): The Home dashboard shows live shoppers, headline metrics for the selected window, most viewed products, a live activity feed, and an evidence-based insight.
- [Products](https://topten.mintlify.app/guides/products.md): Rank your catalogue by views, cart additions, and orders, then open any product for its funnel, timeline, hourly pattern, and behaviour.
- [Trends](https://topten.mintlify.app/guides/trends.md): Spot rising and declining products with fair, equal-length period comparisons, category rankings, and new-product performance.
- [Insights](https://topten.mintlify.app/guides/insights.md): Evidence-based findings with suggested next steps, plus the opportunity radar that ranks products by combined interest, conversion, and stock signals.
- [Settings reference](https://topten.mintlify.app/settings.md): Every setting in Live Product Insights — location, allowed range, default value, and effect.
- [Measurement & definitions](https://topten.mintlify.app/measurement.md): The exact definition behind every metric in Live Product Insights — active viewers, product views, cart activity, attribution, conversion, revenue, and trending rules.
- [Privacy & data handling](https://topten.mintlify.app/privacy.md): What Live Product Insights collects, what it never collects, how visitor consent gates collection, and how data is retained and deleted.
- [Troubleshooting](https://topten.mintlify.app/troubleshooting.md): Symptoms, likely causes, and fixes for the most common Live Product Insights questions — counter not showing, empty dashboards, attribution, and development issues.
- [Architecture Overview](https://topten.mintlify.app/architecture/overview.md): How Live Product Insights works: the storefront tracker, the app proxy, the embedded admin app, Shopify webhooks, and the in-process background scheduler.
- [Storefront Tracker](https://topten.mintlify.app/architecture/storefront-tracker.md): The client-side tracking contract: events, anonymous identity, view dedupe, consent gating, transport, and the Live View Counter block.
- [App Proxy API](https://topten.mintlify.app/architecture/app-proxy-api.md): Reference for the two storefront endpoints: POST /apps/live-view/track (event ingest) and GET /apps/live-view/stats (live count).
- [Webhooks](https://topten.mintlify.app/architecture/webhooks.md): Reference for all 13 webhook topics the app handles: orders, refunds, products, inventory, app lifecycle, and the mandatory privacy webhooks.
- [Data Model](https://topten.mintlify.app/architecture/data-model.md): The 14 SQLite tables behind Live Product Insights: identity and events, commerce, configuration, and operations — plus data lifecycle and deletion paths.
- [Background Jobs](https://topten.mintlify.app/architecture/background-jobs.md): The in-process scheduler: insight generation, order catch-up sync, daily rollups, plan usage reconciliation, and retention pruning.
- [Local Development](https://topten.mintlify.app/development/local-development.md): Set up the Live Product Insights app locally: prerequisites, running the dev server, theme preview, demo data scripts, and the developer gotchas that cost the most time.
- [Testing](https://topten.mintlify.app/development/testing.md): The Live Product Insights test suite: 104 tests across 10 files, how the integration harness boots a real server, load testing, and documented coverage gaps.
- [Deployment](https://topten.mintlify.app/development/deployment.md): How Live Product Insights runs in production: the single always-on Fly.io instance, SQLite on a persistent volume, migration-driven Docker boots, environment variables, and post-deploy verification.
- [Security](https://topten.mintlify.app/development/security.md): The security model of Live Product Insights: proxy and webhook HMAC verification, post-authentication rate limiting, strict input allowlists, store-scoped data access, and the accepted risks we publish openly.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.