Proxy Mail QA for VS Code
Test inboxes for sign-up, login and password-reset testing, inside VS Code, Cursor, Windsurf and Qoder.
Make a test address with a realistic test person, 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.
What it does
- Test addresses in the sidebar. Choose a project, then New address. Pick a country, an age band, an environment, and whether to make a password. The address, the person's details and the password are shown with a copy button each.
- The newest code or link at each address. Codes, sign-in links, reset links, invites and coupons each keep their own colour. Copy a code, or open a link in your browser.
- Wait for a code. Choose Wait for code or Wait for link. The status bar shows "Waiting for code…" for up to two minutes, then the code, with a notification that copies it.
- Tests in one step. Insert a sign-up test adds a Playwright or Cypress test for sign-up with a code, password reset or magic link. The same tests are snippets: type
proxymail- in a TypeScript or JavaScript file.
- Your sign-up form as code. Insert a sign-up form opens one of the project's sign-up forms as React or HTML, with each field's rules and test id. Insert tests for a sign-up form opens Playwright or Cypress tests for it: values each field should take, and values it should refuse.
Get started
- Create an API key in app.proxymail.qa → Project settings → API keys.
- Open the Proxy Mail QA view in the activity bar and choose Add API key.
- Paste the key. VS Code keeps it in its secret storage, and the sidebar never sees it.
Add as many projects as you like and switch between them at the top of the sidebar.
Commands
| 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 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 |
| 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 web app |
| Proxy Mail QA: Remove a project |
Forgets the project and its key |
Tests that use it
The inserted tests use the proxymail-qa npm package:
npm install --save-dev proxymail-qa
Set PROXYMAIL_QA_API_KEY where your tests run. See the Playwright guide and the Cypress guide.
Privacy
The extension talks only to the Proxy Mail QA API (api.proxymail.qa) with your project's key. It sends no usage data of its own. Codes and links are shown as text, never as web content.
More in the docs.