Documentation

Everything you need to get started with Revenue Shield

Documentation

Core Concepts

How Revenue Shield Works

Revenue Shield showing the auto-generated checkout flow tests after install, with flow names, step counts, and ready-to-run status
From index to a complete suite of generated checkout flow tests, ready to run.

Revenue Shield operates as a continuous monitoring pipeline. Tests are generated automatically, executed on a schedule against your live store, and any failures trigger alerts with full evidence. Here is how each stage works.

Stage 1: OOTB Test Generation

When you install Revenue Shield, the system reads your store's product catalog and collection structure via the Shopify API. Using this data, it generates five out-of-the-box checkout flow tests that cover the critical revenue paths on your store. These tests are real Playwright browser automation scripts, not simple HTTP pings or synthetic checks.

The generation process uses AI to identify appropriate products, collections, and search terms specific to your store. The result is a test suite that accurately reflects how a real customer would navigate your storefront.

Stage 2: Scheduling

Tests run on a configurable cadence managed by a cron-based scheduler. The cadence depends on your plan:

  • Free — 3 times daily (approximately every 8 hours)
  • Starter — Every 1 hour (minimum)
  • Growth — Every 1 hour (minimum)
  • Agency — Every 15 minutes (minimum)

You can also trigger tests manually at any time from the dashboard. The scheduler respects your configured timezone and runs consistently regardless of traffic patterns or time of day.

Stage 3: Playwright Execution

Each test run launches a real Chromium browser instance via Playwright. The browser navigates your live storefront exactly as a customer would: loading pages, clicking elements, typing into fields, and waiting for responses. This is not a headless API check. It renders JavaScript, executes third-party scripts, and interacts with dynamic UI elements.

Each test follows a defined flow (for example, navigating from homepage to a product detail page) and asserts that each step completes successfully. If an assertion fails, the test is marked as failed and the pipeline moves to artifact capture.

Stage 4: Artifact Capture

Every test run, whether it passes or fails, generates artifacts:

  • Screenshots — Captured at key checkpoints during the test and on failure
  • Video recordings — A full video of the browser session from start to finish
  • Trace files — Playwright trace archives that can be opened in the Playwright Trace Viewer for step-by-step debugging
  • Console errors — Any JavaScript errors or warnings logged to the browser console during the test

Artifacts are stored in cloud storage and linked from the dashboard and alert notifications. Retention periods vary by plan.

Stage 5: Alerting

When a test fails, Revenue Shield sends notifications through your configured channels (Slack, email, SMS). Each alert includes the test name, a timestamp, the specific step that failed, and direct links to the screenshot and video recording. This allows you to diagnose the issue without needing to reproduce it manually.

Alerts are sent per failure, not per run. If multiple tests fail in the same run, each generates its own alert with its own evidence.

Stage 6: Self-Healing

Shopify stores change frequently. Theme updates, app installations, and content edits can alter the DOM structure without breaking actual functionality. When a test fails because a CSS selector or element locator no longer matches the page, Revenue Shield's self-healing engine uses AI to detect whether the failure is a real problem or a benign UI change.

If the failure is determined to be a selector mismatch (not a genuine checkout failure), the system automatically updates the test with corrected selectors and re-runs it. This prevents false alerts from routine store updates while ensuring real failures are never suppressed.

The Full Loop

The pipeline runs continuously: generate tests, schedule runs, execute in a real browser, capture evidence, alert on failure, and self-heal when appropriate. The result is a monitoring system that requires no ongoing maintenance from you while providing continuous protection for your store's revenue.

Learn More

Need Help?

Can't find what you're looking for? Our team is here to help.