supaguardsupaguardDocs
Monitoring

Testing Email Verification in Gatsby: Ensuring Static-Site activation Reliability

Verify your Gatsby application's email verification flow with Playwright. Learn how to set up synthetic monitoring to detect activation blockers across all regions.

For Gatsby developers building high-performance static sites with dynamic islands, the Email Verification Flow involves verifying that your interactive activation components correctly communicate with your backend or auth provider. If your client-side hydration fails or if your API calls are slow, your users are stuck. This guide covers how to monitor Gatsby email verification flows using supaguard and Playwright.

activation Reliability Strategy

Monitoring email verification flows involves verifying your client-side hydration, API responsiveness, and routing success across all regions.

TargetWhat it VerifiesImpact
Verification PageEnsure that the verification landing page loads and hydrates correctlyUser Activation
API SpeedVerify that your backend activation API responds fast globallyActivation UX
App RedirectionEnsure that users successfully land in the main app with a verified statusRetention

Quick Setup

Step 1: Use a Test Verification Token

  1. Create a dedicated verification test token in your Gatsby app's backend.
  2. Ensure your backend has a way to handle frequent verification requests for this token.
  3. Configure your Gatsby environment to handle test auth states securely.

Step 2: Create the Playwright Monitoring Script

Use this script to verify your Gatsby email verification flow and app landing.

import { test, expect } from '@playwright/test';

test('verify gatsby email verification flow and app landing', async ({ page }) => {
  const startTime = Date.now();

  // 1. Navigate to the verification landing page with a test token
  await page.goto('https://your-gatsby-app.com/verify-email?token=test-token-123');

  // 2. Wait for the activation process to complete
  const activationMessage = page.locator('.activation-success');
  await expect(activationMessage).toBeVisible({ timeout: 15000 });

  // 3. Click "Go to Dashboard" and verify landing
  await page.click('a:has-text("Go to Dashboard")');
  await page.waitForURL('**/dashboard', { timeout: 10000 });

  // 4. Verify successful activation state via UI element
  const dashboardHeading = page.locator('h1');
  await expect(dashboardHeading).toContainText('Dashboard');

  const duration = (Date.now() - startTime) / 1000;
  console.log(`Gatsby email verification verified in ${duration} seconds`);
});

Step 3: Schedule with supaguard

  1. Open your supaguard dashboard and select Create Check.
  2. Paste the script and select all global regions (US, India, UK, etc.).
  3. Set the frequency to every 30 or 60 minutes.
  4. Save the check.

Implementation in supaguard: Performance Benchmarks

Set thresholds for Gatsby verification and dashboard load times.

  • Warning: If activation process takes > 3.0 seconds.
  • Critical: If verification fails or dashboard redirection times out.

The supaguard Advantage

Global Multi-Region Activation Verification

Your Gatsby app's activation API might be fast in North America but slow in Europe due to regional database latency or auth provider delays. supaguard executes your checks from 20+ global regions simultaneously, providing a real-time heat map of your activation flow's global performance.

AI-Native Root Cause Analysis

If a Gatsby email verification check fails, supaguard provides a human-friendly summary: "The verification failed because your auth API returned a 500 Internal Server Error in the Tokyo region." or "The 'Go to Dashboard' button was unclickable due to a client-side hydration error." This allows your team to fix the issue in minutes.

Keep your Gatsby app always growing. Monitor your verification flow with supaguard.

On this page