Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Use Shopify CLI to preview your local theme on a development store, then point Cypress at the preview URL and test the storefront in a real browser. Shopify and Cypress document the pieces separately; the workflow below combines them, rather than relying on a dedicated Shopify–Cypress integration.

What you need before testing

  • A Shopify development store you can access, with representative products and collections for the scenarios you want to test.
  • A valid Shopify theme directory. The expected structure includes folders such as assets, config, layout, locales, sections, snippets and templates. If your build process generates the theme, run Shopify CLI from that generated directory.
  • Shopify CLI authenticated for the target store, and a Cypress project configured according to your team’s existing setup.

Shopify’s theme CLI guide explains theme commands and directory expectations. The Cypress FAQ describes browser testing capabilities, but neither vendor documents a standard combined configuration, preview authentication method or first-party integration.

Create a Shopify theme preview

  1. From the theme directory, start a development preview for your store:
    shopify theme dev --store my-store
    Replace my-store with your store’s handle.
  2. Follow the CLI output. It provides a local preview URL, a link to the Shopify admin theme editor and a shareable preview link. The documented local URL is http://127.0.0.1:9292.
  3. Keep the CLI process running while testing the local preview. CSS and section changes can hot reload; other file changes can refresh the page. Exact behavior depends on the CLI version and options in use.
  4. Use the preview link appropriate to your test runner. Cypress may visit local or remote pages, but your project must decide its base URL, access strategy and environment configuration.

theme dev uploads the local theme as a development theme. Development themes are temporary: Shopify says they are deleted after seven days of inactivity and when you run shopify auth logout. If a preview must remain useful after logout, push the development theme to an unpublished theme instead. For switching stores or environments, Shopify CLI supports repository-level environments configured in shopify.theme.toml; handle credentials using your team’s secret-management practices. See the theme dev reference and the environments guide.

Point Cypress at the preview and test real storefront behavior

In a Cypress test, visit the URL printed by Shopify CLI, then assert against the page a shopper would see. For example, with the local preview running:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
#1 Best Overall
Elebase USB to USB C Adapter for iPhone 18 Pro Max,USBC Car Charger Adapter
  • Read Before You Buy — No Video Output: These adapters support charging and USB 2.0 data transfer, but cannot transmit video signals. Except for standard USB webcams (which use USB data only), they are not compatible with HDMI/DisplayPort cables, video-capable USB-C hubs, or docking stations with video output.
  • Convert USB-A Ports to USB-C: Designed to connect USB-C earphones, cables, flash drives, card readers, and other USB-C accessories to standard USB-A ports. Plug-and-play with no drivers or software required.
  • Aluminum Alloy Housing: Built with a sturdy aluminum alloy shell that aids in heat dissipation and protects against daily wear and scratches. Designed to maintain a stable and secure connection.
  • Compact & Travel-Friendly: The ultra-compact design allows the adapter to stay plugged into your device without blocking adjacent ports or adding bulk, reducing wear and tear on your original USB ports.
  • 12-Month Warranty: Backed by a 12-month manufacturer warranty for peace of mind. Designed to meet strict quality control standards for reliable everyday performance.
describe('theme storefront', () => {
  it('renders the home page and opens a product', () => {
    cy.visit('http://127.0.0.1:9292');

    cy.get('main').should('be.visible');
    cy.get('a[href*="/products/"]').first().click();
    cy.location('pathname').should('include', '/products/');
  });
});

This is a starting pattern, not a Shopify-prescribed test harness. Adapt selectors to your theme and ensure the target URL and fixture data are stable. Cypress waits for a page’s load event after cy.visit(); the vendor’s FAQ documents this behavior.

Choose scenarios that expose theme regressions

  • Open primary navigation and follow links to collections and products.
  • Check collection cards, product details, variant or option controls, and product-form feedback.
  • Exercise cart interactions and confirm the visible result, using the actual store behavior your test environment supports.
  • Check key pages at desktop and narrower viewport sizes. Cypress supports viewport adjustment; use dimensions that reflect the layouts your theme is meant to support.

These are practical coverage recommendations, not a guarantee that a particular preview can exercise every Shopify service or state. Keep selectors tied to meaningful page behavior rather than fragile styling details where possible.

Use Cypress network commands for the right job

cy.intercept() observes, waits for or stubs requests made by the browser. Use it when a test needs to check a storefront request or deliberately supply a controlled response. cy.request() instead makes a request from Cypress’s Node process; it does not pass through the interception proxy and therefore cannot be observed by cy.intercept().

Rank #2
Anker USB-C Hub, 5-in-1 USB Hub for Laptops, 4K HDMI Multiport Adapter
  • 5-in-1 USB-C Hub: Experience comprehensive connectivity featuring a Power Delivery input, two USB-A 2.0 ports, a USB-A 3.0 port, and an HDMI port. (Note: The USB-C power delivery input port is only for connecting an external wall charger to power your laptop and cannot power peripheral devices.)
  • 90W Pass-Through Charging: Achieve optimal charging with 90W pass-through power to your laptop, supported by a total input of 100W, with the hub reserving 10W for operational efficiency. (Note: Wall charger not included.)
  • Quick Data Transfers: Accelerate your productivity with rapid data transfers using a high-speed 5Gbps USB 3.0 port and two 480Mbps USB 2.0 ports.
  • 4K HDMI Display: Enhance your visual experience with a hub capable of delivering 4K resolution at 30Hz in both mirror and extend modes. Please note that this hub is compatible with MacBook (macOS 12 and newer), Windows 10 and 11, ChromeOS, and laptops equipped with DP Alt Mode and Power Delivery. Note: This device is not compatible with Linux.
  • What You Get: Anker USB-C Hub (5-in-1, 4K HDMI), welcome guide, 18-month warranty, and our friendly customer service.

A useful division is to drive a shopper action through the UI, observe browser-originated traffic with cy.intercept(), and use cy.request() only when the runner needs to call an endpoint directly and inspect its response. Endpoint access and any persisted-result checks depend on the store and environment you have configured.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

For tests intended to establish confidence in the integrated preview, avoid stubbing every relevant request: a fully stubbed test can prove that the UI handles a fixture, but not that the real Shopify-backed path works. Keep stubs for focused UI cases and retain tests that exercise the actual preview where appropriate.

Populate the development store with useful test data

Development stores start empty by default, but Shopify offers generated test data with common commerce primitives and configurations intended to help test themes, apps and custom storefronts. Use representative products, collections and configurations that match the behavior under test, and make fixture assumptions explicit in the suite. The official development-store guide describes generated data; it does not prescribe a Cypress-specific fixture workflow.

Rank #3
Sale
Anker USB C Hub, 7in1 Multi-Port USB Adapter, 4K@60Hz USBC to HDMI Splitter
  • Sleek 7-in-1 USB-C Hub: Features an HDMI port, two USB-A 3.0 ports, and a USB-C data port, each providing 5Gbps transfer speeds. It also includes a USB-C PD input port for charging up to 100W and dual SD and TF card slots, all in a compact design.
  • Flawless 4K@60Hz Video with HDMI: Delivers exceptional clarity and smoothness with its 4K@60Hz HDMI port, making it ideal for high-definition presentations and entertainment. (Note: Only the HDMI port supports video projection; the USB-C port is for data transfer only.)
  • Double Up on Efficiency: The two USB-A 3.0 ports and a USB-C port support a fast 5Gbps data rate, significantly boosting your transfer speeds and improving productivity.
  • Fast and Reliable 85W Charging: Offers high-capacity, speedy charging for laptops up to 85W, so you spend less time tethered to an outlet and more time being productive.
  • What You Get: Anker USB-C Hub (7-in-1), welcome guide, 18-month warranty, and our friendly customer service.

Know the checkout boundary

Shopify explicitly states: “You can’t preview checkout customizations using http://127.0.0.1:9292.” Cypress tests against that local preview can cover storefront theme behavior, but they should not be presented as validation of checkout customizations. The cited Shopify and Cypress documentation does not establish a Cypress-supported procedure for hosted checkout testing, so use Shopify’s current supported checkout test environment and guidance for that separate task. See Shopify’s theme dev reference.

Complement browser tests with theme checks

Cypress covers rendered browser interactions; it is not the only useful layer in a theme-testing plan. Shopify CLI can run Theme Check. Shopify’s theme-testing article also discusses inspecting navigation and product forms with JavaScript disabled and using Lighthouse against a development-store preview link. Treat that article as broad testing guidance, not a definitive current Theme Store submission checklist.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Testing layer What it helps check Important boundary
Theme Check Theme code analysis Does not replace rendered UI testing.
Cypress browser tests Rendered pages and shopper-facing interactions Coverage depends on preview, data and assertions.
cy.intercept() Browser-originated network traffic; spying, waiting or stubbing Does not observe runner-originated cy.request() calls.
cy.request() Direct endpoint requests made from Cypress’s Node process Does not pass through Cypress’s browser interception proxy.
Lighthouse and manual checks Performance-oriented inspection and behavior with JavaScript disabled Complementary checks, not Cypress features.

Troubleshoot common setup failures

The CLI rejects the current directory

theme dev expects a valid theme structure. Change to the theme root, or to the generated theme directory if a build step produces the files Shopify should preview.

Rank #4
Sale
UGREEN USB to USB C Adapter Combo 4-Pack, 10Gbps USB C Converter Space Gray
  • Dual Converters, Infinite Potential:Includes 2× USB C male to USB A female adapters and 2× USB A male to USB C female adapters. Perfect for a wide range of uses—tablets with Bluetooth keyboards, expand USB ports on macbook, and more. Two different converters for all your daily needs
  • Next-Level 10Gbps & 3A Charging: No more slow 480Mbps, this usb to usb c adapter has a transfer speed of up to 10Gbps, allowing you to do more transferring in less time. This usb adapter fits both USB A and USB C charger, supporting up to 3A fast charging
  • Upgraded Exquisite Craftsmanship: With an aluminum alloy housing and metal connector, the usbc to usb adapter is extremely durable and sturdy. Rigorously tested to withstand more than 10,000 times of plugging and unplugging, ensuring long-lasting performance
  • Broad Compatible: The usb c to usb adapter widely supports all USB C/ USB A devices like laptops, tablets, cellphones, car chargers, and phone chargers. Such as compatible with MacBook Pro/Air 2023/2022, Thunderbolt 4/3 Devices,Apple MagSafe Watch 9/8/7/SE/Ultra, iPad Pro 2022/2021, Samsung Galaxy S23/S20/S10, and iPhone 17/16/15 Pro. Plug and play
  • Please Note: To reach 10Gbps speed, keep the cable under 3.3 ft. For USB A Male to USB C adapters, try flipping the USB C connector. USB C Male to USB A adapters support bidirectional 10Gbps transfer within 3.3 ft

Cypress cannot load the preview

Confirm that shopify theme dev is still running and that Cypress is visiting the URL the CLI printed. If using a remote shareable link, check the link and store access in the browser context used by your tests; the vendor documentation does not define a universal authentication recipe for Cypress.

The preview changed or disappeared

A development theme can be replaced by another theme dev run for the active environment, and Shopify deletes development themes after seven days of inactivity or on shopify auth logout. Start the preview again or use an unpublished theme when persistence after logout is required.

Checkout customization assertions fail on localhost

This is a preview limitation, not necessarily a Cypress defect. Shopify says checkout customizations cannot be previewed at http://127.0.0.1:9292; keep those tests separate from local theme-preview coverage.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Best Value
Anker USB C Hub, 5-in-1 USBC to HDMI Splitter with 4K Display
  • 5-in-1 Connectivity: Equipped with a 4K HDMI port, a 5 Gbps USB-C data port, two 5 Gbps USB-A ports, and a USB C 100W PD-IN port. Note: The USB C 100W PD-IN port supports only charging and does not support data transfer devices such as headphones or speakers.
  • Powerful Pass-Through Charging: Supports up to 85W pass-through charging so you can power up your laptop while you use the hub. Note: Pass-through charging requires a charger (not included). Note: To achieve full power for iPad, we recommend using a 45W wall charger.
  • Transfer Files in Seconds: Move files to and from your laptop at speeds of up to 5 Gbps via the USB-C and USB-A data ports. Note: The USB C 5Gbps Data port does not support video output.
  • HD Display: Connect to the HDMI port to stream or mirror content to an external monitor in resolutions of up to 4K@30Hz. Note: The USB-C ports do not support video output.
  • What You Get: Anker 332 USB-C Hub (5-in-1), welcome guide, our worry-free 18-month warranty, and friendly customer service.

An intercepted request never appears

Check whether the request is made by the browser or through cy.request(). Cypress does not route the latter through the cy.intercept() proxy.

Pages render without products or the needed state

Development stores may be empty. Add or generate representative test data, then ensure the products, collections and configuration states used by the test actually exist in the selected store.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Or skip the browser setup

For a saved screenshot of a preview page rather than an interactive Cypress test, ScreenshotNeo provides a one-request screenshot API and an MCP server. For example, point it at the shareable storefront preview URL:

curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://your-preview-url -o shot.webp

See the ScreenshotNeo API documentation for request options. ScreenshotNeo accepts cookie or consent banners like a visitor and removes more than 60 known consent platforms, newsletter popups and chat widgets before capture; each step can be turned off. Bot checks, blank pages and failed loads are not billed, and responses include X-Page-Verdict and X-Billed headers. Its MCP server provides take_screenshot, get_page_info and capture_pdf for AI agents. The free plan includes 1,000 screenshots per month with no card; paid plans start at $5 for 3,000 screenshots. A screenshot is a visual artifact, not a substitute for Cypress interaction and assertion coverage. Learn about ScreenshotNeo, or sign up for 1,000 free screenshots a month with no card.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Frequently Asked Questions

Does Shopify provide an official Cypress integration for theme testing?

The documented workflow combines Shopify CLI previewing with Cypress browser tests; the cited vendor documentation does not describe a dedicated integration.

Can Cypress test a Shopify theme preview on mobile-sized screens?

Yes. Cypress supports viewport adjustment, so tests can exercise the theme at selected viewport dimensions.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.