StorePulse User Guide

Everything you need to know about installing, configuring, and getting value from StorePulse.

1. Install & setup

Open the StorePulse listing on the Shopify App Store and click Install. Approve the requested permissions on Shopify's consent screen — read products, themes, orders, and inventory; write a script tag and a metafield used by the Theme App Embed.

After install, StorePulse opens to the dashboard. Two things happen automatically:

1. A snippet token is generated and stored as a Shopify metafield. The Theme App Embed uses this to authenticate event ingestion.
2. The StorePulse Web Pixel is registered for checkout-funnel tracking.

Open Online Store → Themes → Customize on your published theme. In the App embeds section, enable StorePulse Tracking and click Save. That's the only manual step.

Visit your storefront once. Within 30 seconds, the Settings page should show Storefront tracking delivered: active on storefront.

2. Dashboard tour

The dashboard at /app shows a "today snapshot" — open errors, synthetic checkout 24h success rate, open alerts, push-recovery ROI, plus a "customer revenue at risk" headline. Each card links to its detail page. Use this as a daily check-in; jump to a feature page for deeper analysis.

3. Errors monitoring

The Errors page lists JavaScript errors and unhandled rejections grouped by stack signature. Click an issue to see:

• First seen / last seen timestamps and total occurrences.
• The full stack trace from the most recent occurrence.
• Per-page distribution — which URLs trigger this error.
• Status (open / resolved / ignored). Mark resolved when you've shipped a fix; the issue auto-reopens if it occurs again.

Use the filter chips at the top to narrow by type (JS error, unhandled rejection, network error, cart error, checkout error) or status. Search by message or stack text.

4. AI fixes

From any error detail page, click Get AI fix (2 credits). StorePulse sends the error message, stack trace, and recent samples to Claude (Anthropic) and returns a structured fix proposal:

• Why it broke — root cause analysis.
• File path — the theme file to open in Code Editor.
• Before code — the exact snippet to find.
• After code — the safe replacement.
• How to verify — what to test in the browser console or storefront.

The fix is a recommendation, not an automatic patch. Review it, paste into your theme via Shopify's Code Editor, save, and visit the affected page to confirm the error is gone. Mark the issue resolved.

If the fix is wrong (rare), email support@deepseatools.in with the issue ID — we credit the cost back and improve the prompt.

5. Synthetic Checkout Monitor

Available on Starter+. Every 15 minutes (configurable down to 5 minutes on higher plans) a real headless Chromium browser, running on Cloudflare Browser Rendering, walks your live storefront: loads home, picks a buyable test product, adds it to cart, opens /cart, then opens /checkout and asserts the checkout page rendered with real email / customer / Shop Pay inputs.

Each run lands in checkout_monitor_runs with status ok, failed, or skipped (the latter for password-protected stores, so a pre-launch site doesn't generate false alerts). The dashboard's Checkout monitor card surfaces the 24-hour success rate and the latest-run status with a one-click Run check now button for ad-hoc verification.

Two consecutive failures fire a Checkout broken alert with the failed step, the failure message, and the test product handle — so you know precisely where in the purchase flow the breakage is. The next successful walk fires a Checkout recovered notice so the team knows the incident is over without scanning the dashboard.

6. Push Recovery

Available on Starter+. The storefront snippet asks for browser push permission at strategic moments (right after add-to-cart). When a shopper abandons their cart past the configured threshold (default ~5 minutes, configurable per plan), StorePulse delivers a push that links straight back to /cart with a merchant-customized title, body, and product image.

Two privacy / deliverability features are built in:

• Only-on-issue mode — push delivery is gated on a correlated technical issue in the shopper's session (JS error, network failure on /cart or /checkout, rage click). Stops "we just want your money" sends when nothing was actually broken.
• Wave delays — staggered delivery across configurable wave buckets so all pushes don't fire in the same minute and hammer your storefront.

The Push recovery dashboard card shows pushes sent → carts recovered → revenue back over the last 7 days, so the feature's ROI is visible at a glance.

7. Theme Review

Theme Review (Starter+) audits your theme code with Claude paired with a runtime accessibility scan. Three tiers:

• Quick — 30 files, 25 credits. Good for a fast sanity check before publishing a small change.
• Standard — 80 files, 75 credits. Recommended for most stores. Covers most templates, sections, and snippets.
• Deep — 150 files, 150 credits. Full theme audit including custom snippets, vendor JS, and Liquid sections.

Click a tier card, confirm in the modal, and the review starts. You can leave the page — the review runs in the background. Findings appear in real time as Claude completes each batch. Filter by category (Security · Accessibility · Performance · SEO · Best practice) to triage.

Each finding shows severity, file path, line number, the offending code, plain-English explanation, and recommended replacement code. Mark each as resolved or ignored when you handle it.

Cancellation: Click Cancel review on any running job. Claude calls stop immediately and no credits are charged.

8. Accessibility Scanner

The Accessibility Scanner runs WCAG 2.2 AA audits on your storefront using axe-core. Three scopes:

• Storefront audit (Starter+) — up to 150 pages diversified across home, cart, search, top products, top collections, static pages from sitemap, policy pages, and account flows. Each page is scanned in its own fresh browser session, so a single slow page can't stall the rest of the scan.
• Group of pages (Starter+) — focus on Product pages, Collection pages, static Pages, or Others (search/cart/policies). Up to 20 per group.
• Specific page (Free plan available) — paste any URL on your storefront. Useful for QA-ing a single landing page.

Each audit returns:

• Accessibility score (0–100) and lawsuit-risk rating (High / Medium / Low).
• Violation breakdown by severity — Critical / Serious / Moderate / Minor.
• Per-finding remediation — what's wrong, exact CSS selectors of affected elements, recommended fix, and a link to the W3C "Understanding" page for the WCAG criterion.

Schedule: On Starter+, configure daily or weekly auto-scans from Settings → Accessibility scanner. Useful for catching regressions before they ship to customers.

9. Alerts

StorePulse fires email alerts when something matters. The Alerts page shows recent alerts with filters for severity, type, status, and time range. Each alert can be marked resolved or reopened. New-issue alerts dedupe per fingerprint — one email per unique error, not per occurrence.

Configure alerts under Settings → Alert notification emails. Add up to 3 recipient emails. Per-rule toggles let you enable/disable each alert type and set thresholds for spike-based rules.

10. Settings

The Settings page consolidates all configuration:

• Storefront tracking — installation status, snippet token, observed URL count.
• Activation checklist — confirms install / delivery / events.
• Tracking controls — reconnect or remove tracking.
• Alert notification emails — up to 3 recipients.
• Alert rules — per-rule toggles and thresholds.

11. Billing

The Billing page shows your current plan, AI credit usage for the month, plan source (Shopify subscription vs free tier), and active subscription details. Click any plan card to upgrade or downgrade — Shopify handles approval and pro-ration automatically.

Credits refresh on the 1st of each month. Usage warning banners appear at 80% and 100%.

12. Uninstalling

Before uninstalling, click Remove StorePulse tracking in Settings. This deletes our app embed token and removes any legacy ScriptTag delivery so your storefront isn't loading our snippet anymore.

Then uninstall from Shopify Admin → Settings → Apps. Per Shopify's GDPR mandatory webhooks, all your data (events, errors, vitals, alerts, audits) is permanently deleted within 48 hours.