> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zerodrop.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# ZeroDrop Documentation

> Disposable email inboxes for CI pipelines. No Docker. No SMTP. No signup.

## What is ZeroDrop?

ZeroDrop gives your Playwright and Cypress tests a real email inbox — instantly. Send a verification email, catch it at the edge, extract the OTP automatically, and complete the flow.

No Docker container. No SMTP server. No mocking.

## Quick install

```bash theme={null}
npm install zerodrop-client
```

```typescript theme={null}
import { ZeroDrop } from 'zerodrop-client';

const mail = new ZeroDrop();
const inbox = mail.generateInbox();

// Wait for email — OTP auto-extracted, no regex needed
const email = await mail.waitForLatest(inbox, { timeout: 30000 });
console.log(email.otp);       // "123456"
console.log(email.magicLink); // "https://..."
```

## Get started

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/quickstart">
    Install the SDK and write your first email test in under 5 minutes.
  </Card>

  <Card title="Playwright" icon="play" href="/playwright">
    Full guide for email verification, OTP, and password reset flows in Playwright.
  </Card>

  <Card title="GitHub Actions" icon="github" href="/github-actions">
    Add a disposable inbox to your CI pipeline with one Action.
  </Card>

  <Card title="SDK Reference" icon="code" href="/sdk-reference">
    Full API documentation for zerodrop-client.
  </Card>
</CardGroup>

## How it works

1. **Generate an inbox** — local, instant, no network request
2. **Send an email** — your app sends a real verification email
3. **Catch it at the edge** — Cloudflare Worker catches it, Llama 3.1 filters spam
4. **Auto-extract OTP** — stored alongside the email, ready to use
5. **Sub-second delivery** — SDK uses SSE, falls back to polling

## Zero telemetry

ZeroDrop does not track your test suites, build environments, project names, or CI runner metadata. Your CI pipeline is your business.
