npm install --save-dev zerodrop-client cypress

// cypress.config.js
const { defineConfig } = require('cypress');
const { ZeroDrop } = require('zerodrop-client');

// Runs in Node, where it reads ZERODROP_API_KEY
const mail = new ZeroDrop();

module.exports = defineConfig({
  e2e: {
    baseUrl: 'http://localhost:3000',
    setupNodeEvents(on) {
      on('task', {
        newInbox: () => mail.generateInbox(),
        waitForEmail: ({ inbox, timeout = 30000 }) =>
          mail.waitForLatest(inbox, { timeout }),
      });
    },
  },
});

// cypress/e2e/auth.cy.js
describe('Email verification', () => {
  it('user can sign up and verify email', () => {
    cy.task('newInbox').then((inbox) => {
      cy.visit('/signup');
      cy.get('[data-testid="email"]').type(inbox);
      cy.get('[data-testid="submit"]').click();

      cy.task('waitForEmail', { inbox }).then((email) => {
        expect(email.otp).to.not.be.null;

        // Enter OTP
        cy.get('[data-testid="otp"]').type(email.otp);
        cy.get('[data-testid="verify"]').click();
        cy.url().should('include', '/dashboard');
      });
    });
  });
});

it('OTP login', () => {
  cy.task('newInbox').then((inbox) => {
    cy.visit('/login');
    cy.get('[data-testid="email"]').type(inbox);
    cy.get('[data-testid="submit"]').click();

    cy.task('waitForEmail', { inbox }).then((email) => {
      // OTP auto-extracted — no regex needed
      cy.get('[data-testid="otp"]').type(email.otp);
      cy.get('[data-testid="verify"]').click();
    });
  });
});

it('magic link verification', () => {
  cy.task('newInbox').then((inbox) => {
    cy.visit('/signup');
    cy.get('[data-testid="email"]').type(inbox);
    cy.get('[data-testid="submit"]').click();

    cy.task('waitForEmail', { inbox }).then((email) => {
      // Navigate to verification link
      cy.visit(email.magicLink);
      cy.url().should('include', '/dashboard');
    });
  });
});

- name: Run Cypress tests
  run: npx cypress run
  env:
    ZERODROP_API_KEY: ${{ secrets.ZERODROP_API_KEY }}
    CYPRESS_BASE_URL: ${{ secrets.STAGING_URL }}