Welcome
Central documentation for Plop and inbox automation playbooks.
This site collects product documentation, internal playbooks, and platform references for Plop (plop.email). Use it to track UI flows, data contracts, and operational notes in one place.
Getting Started
Quick Start
Get started testing emails in 5 minutes with code examples for Playwright, Cypress, Jest, and pytest.
Testing Patterns
Common patterns for testing magic links, OTPs, password resets, and transactional emails.
Messages API
Full API reference for listing and fetching inbox messages.
E2E: pull latest email
Advanced polling patterns with Playwright and retry logic.
TypeScript SDK
Install @plop-email/sdk and use waitFor() to poll for emails in your tests.
Python SDK
Install plop-sdk with sync and async clients for pytest and beyond.
Platform Architecture
System overview
Understand how the apps and packages fit together.
Inbox pipeline
Follow the inbound email flow from Cloudflare to the UI.
Domains & Mailboxes
Root vs custom domains, tags, and mailbox resolution.
Reserved Names
Security protections against phishing and impersonation.
Contributing
- Add new docs under
apps/docs/content/docs. - Update
apps/docs/content/docs/meta.jsonto order pages and sections. - Keep docs focused on decisions, flows, and operational steps.