Miracle PC Builder

PC Builder — MW

Compatibility Logic Guide

How the storefront widget matches parts, checks power, and builds a valid PC — with real examples.

Last Updated: June 30, 2026

This guide walks through the compatibility engine behind Miracle PC Builder — the part of the app that decides which components a shopper is allowed to see at each step. Everything here is driven by tags you set on your own products, so once you understand the three building blocks below, you can predict exactly what the widget will show for any combination in your catalog.

🎬Watch: automatic compatibility filtering

Open on YouTube →
1

What “Compatibility” Means in This App

Compatibility is simply a rule that says: “this part can only be shown if it agrees with a part the shopper already picked.” The app checks this using three building blocks:

Compatibility building blocks
Building BlockPlain-English MeaningExample
WidgetOne complete PC Builder tool a merchant sets up on their store“Gaming PC Builder”
StepOne stage of the build — one product category“Choose your Motherboard”
Compatibility TagThe specific attribute being compared between parts“Socket Type”, “Memory Type”, “Output Wattage”
Tag ValueThe actual value stamped on one productCPU #A1 → Socket Type = “AM5”

Key Idea

Filtering only ever compares the SAME tag name across steps. “Socket Type” on a CPU is only ever checked against “Socket Type” on a Motherboard — never against an unrelated tag.
2

Worked Example — Matching by Socket Type

Imagine a shopper is building a Gaming PC. Step 1 is “Choose your CPU.” They pick a Ryzen CPU that uses socket “AM5.”

Step 1 — CPU chosen

CPU selected by the shopper
ProductTag: Socket TypeResult
Ryzen 7 9700XAM5✓ Selected

Step 2 — Motherboard step is now filtered

The app looks at every motherboard in the collection and compares its “Socket Type” tag to “AM5.” Only matches are shown to the shopper:

Motherboards filtered by socket type
MotherboardTag: Socket TypeShown to Shopper?
MSI B650 TomahawkAM5✓ Shown — matches
Asus ROG X670EAM5✓ Shown — matches
Gigabyte Z790 AorusLGA1700✕ Hidden — different socket
ASRock B550 ProAM4✕ Hidden — different socket

Why this matters

Without this check, a shopper could accidentally add an LGA1700 motherboard to a cart with an AM5 CPU — parts that physically cannot work together. The app prevents that mistake before it happens.
3

Worked Example — Matching by Memory Type

The same logic repeats for every tag a merchant defines. Continuing the same build, once the Motherboard (MSI B650 Tomahawk, supports DDR5) is chosen, the RAM step is filtered by “Memory Type”:

RAM kits filtered by memory type
RAM KitTag: Memory TypeShown to Shopper?
Corsair Vengeance 32GBDDR5✓ Shown — matches
G.Skill Trident Z5 32GBDDR5✓ Shown — matches
Kingston Fury 16GBDDR4✕ Hidden — wrong generation

A merchant can add as many tags per step as needed — Socket Type, Memory Type, Form Factor, Interface (PCIe version), and more — and every one of them narrows the next step the same way.

4

Worked Example — Power (Wattage) Matching

Power matching works differently from socket/memory matching: instead of an exact match, the app adds up power needs and looks for “enough or more.”

Step A — the app totals power as parts are picked

Running power draw total
Part ChosenTag UsedPower DrawRunning Total
Ryzen 7 9700X (CPU)Power Draw105 W105 W
RTX 4070 (GPU)Power Draw200 W305 W
2× Case FansPower Draw10 W315 W
AIO Liquid CoolerPower Draw25 W340 W

Step B — with a safety margin, the app needs a PSU rated ≥ 400 W

The app applies headroom above the raw total so the PSU isn't running at its limit — in this example, roughly 340 W × ~1.2 ≈ 400 W minimum.

Power supplies filtered by output wattage
Power SupplyTag: Output WattageShown to Shopper?
Corsair RM750e750 W✓ Shown — enough headroom
EVGA 500 BQ500 W✓ Shown — enough headroom
Cooler Master 350W350 W✕ Hidden — not enough power

Important distinction

“Power Draw” (what a part uses) and “Output Wattage” (what a PSU can supply) are two different tags. The app never confuses them — a cooler's 25 W power draw is never mistaken for a PSU's 750 W output capacity, and vice-versa.
5

The Full Build Flow, Visually

Putting it all together, here is the same example build moving through every step:

Full build flow across every step
StepShopper PicksTag Checked Against Later Steps
1. CPURyzen 7 9700XSocket Type = AM5  |  Power Draw = 105W
2. MotherboardMSI B650 TomahawkSocket Type = AM5 ✓  |  Memory Type = DDR5
3. RAMCorsair Vengeance 32GBMemory Type = DDR5 ✓  |  Power Draw = 12W
4. GPURTX 4070Power Draw = 200W
5. Case / Fans / CoolerCase + 2 Fans + AIO CoolerPower Draw = 35W combined
6. PSUCorsair RM750eOutput Wattage = 750W ≥ required 400W ✓

End result

Every part in the cart is guaranteed to physically work together — right socket, right memory type, and enough power — before the shopper ever reaches checkout.
6

What Happens After a Valid Build Is Chosen

  • All chosen parts are added to the cart as one bundle line, so the cart stays clean and simple.

  • At checkout, the app automatically splits that bundle back into one line item per part, so the receipt clearly lists every component and its price.

  • If the merchant configured a discount on the widget, it is spread proportionally across every split-out line item.

7

Where a Merchant Controls All of This

Where each setting lives in the app
What to ConfigureWhere
Add / reorder build steps, choose collectionsWidget Editor
Define compatibility tags (Socket Type, Memory Type, etc.) and tag productsStep Editor
Set wattage values on products (just a tag, same as any other)Step Editor
Auto-suggest tag values with AI instead of typing every one by hand“Fill with AI” (paid feature)
Set discount % / amount and widget appearanceWidget Settings

In one sentence

The app narrows product choices step-by-step using merchant-defined tags, makes sure the power supply can handle the total load, and hands the whole selection to checkout as a clean, itemized bundle.