> For the complete documentation index, see [llms.txt](https://docs.turboload.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.turboload.ai/getting-started/overview.md).

# Architecture & How It Works

Understanding how TurboLoad collects, analyzes, and presents performance metrics will help you make the best data-driven optimization decisions for your Shopify store.

***

## The Hybrid Data Philosophy

Most performance tools rely exclusively on **synthetic lab tests** (like Google PageSpeed Insights or Lighthouse simulated on an emulated mobile device) or inject heavy tracking libraries that slow down your shoppers.

TurboLoad solves this by combining **real-user experience data** with **zero-impact app detection**:

```mermaid
flowchart TD
  subgraph Shoppers ["Your Storefront Visitors"]
    S["Real Customers Browsing & Buying<br/>(Mobile & Desktop Shoppers)"]
  end

  subgraph Intelligence ["TurboLoad Speed Intelligence"]
    RUM["Real-User Experience Analysis<br/>(Largest Contentful Paint, Interaction to Next Paint)"]
    APP["App Impact Attribution<br/>(Identifies Slow Tracking Scripts & Widgets)"]
    ENG["TurboLoad Performance Engine<br/>(Calculates Store Speed Score & Prioritizes Fixes)"]
  end

  subgraph Results ["Merchant Outcomes"]
    OUT["Executive Dashboard & 1-Click Fixes<br/>(Faster Load Times · Higher SEO Rankings · Lifted Conversion Rates)"]
  end

  S --> RUM
  S --> APP
  RUM --> ENG
  APP --> ENG
  ENG --> OUT
```

1. **Genuine Shopper Experience (Core Web Vitals):**\
   Google ranks your store based on field data from real shoppers visiting your site. TurboLoad measures how actual customers experience your pages—from initial click to interactive checkout—without running synthetic lab tests.
2. **Zero-Impact App Bottleneck Detection:**\
   To identify *which* specific apps (e.g. reviews, popups, analytics, live chat) are causing slowdowns, TurboLoad isolates third-party script delays passively. It never adds bulk or delay to your storefront.

***

## Synthetic Lab vs. Real User Monitoring (RUM)

Merchants frequently ask: *“Why is my TurboLoad score different from Google PageSpeed Insights?”*

| Metric Aspect            | Google PageSpeed Insights (Lab)                           | TurboLoad (Real User Monitoring / Field)                              |
| ------------------------ | --------------------------------------------------------- | --------------------------------------------------------------------- |
| **Data Source**          | Single emulated test run on a throttled CPU / 4G network  | Thousands of real shopper sessions across various devices & locations |
| **User Interaction**     | No real human interactions (cannot measure real INP)      | Real shoppers clicking menus, searching, and checking out             |
| **Third-Party Variance** | May run before dynamic third-party scripts finish loading | Captures full lifecycle of apps impacting shoppers                    |
| **SEO Impact**           | Indicative lab score                                      | Exact metric family Google uses for ranking search results            |

{% hint style="info" %}
**Real-World Data Notice:**\
Real-user performance scores are calculated over rolling customer visits. While detected app slowdowns appear in near-real-time, overall Core Web Vitals update progressively over **24 to 36 hours** as shoppers navigate your store. When you apply an optimization, expect to see your field score rise over the following 1–2 days.
{% endhint %}

***

## Seamless Shopify Theme Compatibility

TurboLoad is engineered to work effortlessly across all modern Shopify themes:

* **Zero Liquid Contamination:** All optimizations and telemetry run through official Shopify theme extensions, leaving zero residual code if uninstalled.
* **Support for All Major Themes:** Works out of the box with Dawn, Impulse, Prestige, Focal, Symmetry, Broadcast, and custom headless or agency builds.
* **Safe Testing First:** Any automated code enhancements are always performed inside an isolated draft sandbox, so your live storefront is never at risk.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.turboload.ai/getting-started/overview.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.