Skip to content

Proxy Mail QA for VS Code puts your test addresses beside your code. Make an address in the sidebar, sign up with it in your app, and the code or link from the email shows up in the sidebar, ready to copy. Choose Wait for code and the code shows in the status bar as well. It also inserts Playwright and Cypress tests for sign-up, password reset and magic links.

It’s on the Visual Studio Marketplace for VS Code, and on Open VSX for Cursor, Windsurf, Qoder and other editors built on VS Code.

  1. In VS Code, open Extensions, search for Proxy Mail QA and choose Install. In Cursor, Windsurf or Qoder, the same search finds it on Open VSX.

  2. Create an API key for the project. Open the Proxy Mail QA view in the activity bar, choose Add API key and paste the key.

    VS Code keeps the key in its secret storage. The sidebar never sees it: it gets the addresses and codes, and asks VS Code to do the rest.

  3. Under New address, pick a country, an age band and an environment if you like, and whether to make a password. Choose New address.

    The address, the test person’s details and the password are shown with a copy button each. The password is shown only until you choose Done, so copy it first.

  4. Sign up in your app with the address, then choose Wait for code. The status bar shows “Waiting for code…” for up to two minutes. When the email arrives, the code shows in the status bar and a notification offers Copy code.

Part What it does
Project Switches between the projects you’ve added
New address Makes a test address with a test person, for the country, age band and environment you pick
Codes and links Your live addresses, newest first, each with the newest code, link or coupon from its email
An address’s row Open it for the test person’s details, each with Copy, and Wait for code or Wait for link
A link Copy link, or open it in your browser

Each kind of email keeps its colour, as in the app: codes, sign-in links, reset links, invites and coupons. The list refreshes every 15 seconds while the sidebar is open.

For a Pakistani test person, the details include the name in Urdu. For a Japanese one, they include how the name is read.

Open the command palette and type Proxy Mail QA.

Command What it does
Proxy Mail QA: Add a project’s API key Adds a project from its API key
Proxy Mail QA: New address Makes a test address with the sidebar’s choices and copies it
Proxy Mail QA: Wait for a code Waits for a code at an address you choose
Proxy Mail QA: Wait for a link Waits for a link at an address you choose
Proxy Mail QA: Copy the latest code or link Copies the newest code or link at an address you choose
Proxy Mail QA: Insert a sign-up test Inserts a Playwright or Cypress test for sign-up, reset or magic link
Proxy Mail QA: Insert a sign-up form Opens one of the project’s sign-up forms as React or HTML code
Proxy Mail QA: Insert tests for a sign-up form Opens Playwright or Cypress tests for one of the project’s sign-up forms
Proxy Mail QA: Open in Proxy Mail QA Opens the project in the app
Proxy Mail QA: Remove a project Forgets the project and its key

Insert a sign-up test asks which test you want and adds it where your cursor is. The same tests are snippets in TypeScript and JavaScript files: type proxymail- and pick one.

Snippet The test
proxymail-signup-playwright Signs up with a new address and enters the code from the email
proxymail-reset-playwright Borrows a test account, resets its password from the email’s link, gives it back
proxymail-magic-link-playwright Signs in with a magic link from the email
proxymail-signup-cypress The sign-up test, with cy.proxymail
proxymail-reset-cypress The password reset test, with cy.proxymail
proxymail-magic-link-cypress The magic link test, with cy.proxymail

The tests use the proxymail-qa npm package. Set it up with the Playwright or Cypress guide, and set PROXYMAIL_QA_API_KEY where the tests run.

Insert a sign-up form asks which of the project’s sign-up forms you want and in which kind of code: React with react-hook-form and zod, React with plain state, or one HTML page. It opens the code in a new editor, with notes at the top on what to check, and offers to copy the install command for any packages it needs.

Insert tests for a sign-up form asks for a form and a test runner, Playwright or Cypress, and opens tests that try values each field should take and values it should refuse. Notes at the top say what to check, and it offers to copy the install command.

Each field keeps its data-testid, so the form’s custom fields fill it. Your coding agent builds the forms with you, from a screenshot or what you describe.

The extension talks only to the Proxy Mail QA API, with your project’s key, and sends no usage data of its own. Codes, links and names from emails are shown as text, never as web content.

To remove a project and its key, run Proxy Mail QA: Remove a project.