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" — top errors, recent vitals, uptime status, and pending alerts. 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 (5 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. Performance & Core Web Vitals

The Performance page shows real-user vitals — LCP, CLS, INP, FCP, TTFB — measured on actual visitors. Each metric is rated good / needs-improvement / poor based on Google's published thresholds.

Drill down by URL to see which pages drag down your scores. The product page that takes 6s to render is far more useful to know about than your home page (which Shopify already optimizes well).

Vitals don't appear instantly after install — they require real page views. Expect first numbers within a few hours of enabling the Theme App Embed on a live storefront.

6. Uptime monitoring

StorePulse pings your storefront every 5 minutes from Cloudflare's edge. By default we check:

• Home page (/)
• Top 3 collections (auto-discovered)
• Cart page (/cart)
• Refund and privacy policies (/policies/*)

Each check records HTTP status and response time. Failures trigger a Storefront offline alert (if enabled). The Uptime page shows recent check history with status and latency. Slow-but-up degradation also surfaces — useful for catching CDN or app-extension issues.

7. SEO Monitor

Every 6 hours, StorePulse audits high-traffic URLs for on-page SEO issues. Findings are logged in the SEO Monitor page, grouped by category:

• Broken links — outbound and internal 4xx / 5xx links found in your HTML.
• Meta gaps — missing or duplicate <title> and <meta description>.
• Canonical issues — pages with conflicting or missing canonical tags.
• Image alt — images without alt text (hurts accessibility and image search).
• Structured data — missing Product / BreadcrumbList schema on product pages.

8. 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.

9. Accessibility Scanner

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

• Storefront audit (Starter+) — up to 50 pages diversified across home, cart, search, top products (12), top collections (8), static pages from sitemap (10), policy pages, and account flows.
• Group of pages (Starter+) — focus on Product pages, Collection pages, static Pages, or Others (search/cart/policies). Up to 50 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.

10. 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.

11. 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.

12. 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%.

13. 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.