The public record.

Everything on this page is public, dated and checkable. Where a name or a quote appears, it is there because it was published, and there is a link to the place it was published.

Adopters

The projects and teams that use the mocks. The list is a file in the repository, ADOPTERS.md, and it grows by pull request — so it is public, reviewable, and cannot be inflated.

WhoWhat it is used forSince
Example CoOffline payment testingadd yours

The row above is an example. It shows the shape of a row, not a real adopter.

Adding yourself

Open a pull request that adds a row to ADOPTERS.md. That is all — no form, no email, no account. A row looks like this:

| Acme Ltd | The payment tests in our Laravel checkout | 2026 |

If you would like a logo next to your name, put an SVG in docs/logos/ — monochrome, about 32px tall — and link it.

If you use the mocks and would rather not be listed, that is completely fine. The list is for the people who want to be found.

Press and mentions

Links to blog posts, talks, newsletters and social posts about the project belong here. If you have written about the mocks, or spoken about them, or put them in a newsletter, the link goes in this table.

WhereWhat it saysLink
example onlyan example of a post about the projectlink to the post

The row above is a placeholder. It is not a real mention.

Submitting one

Open an issue with the link. That is enough, and it is the quickest way to have it recorded. A pull request that adds a row to this page is better still, because the entry is then dated, public and reviewable in the same way as the adopters list.

What people say

Words from the people who use it are collected from the public GitHub Discussions. Each one links back to where it was written, so it can be checked.

Nothing is published here that is not verifiable. If a quote cannot be linked to a public discussion, it does not go here — not even as an illustration of the kind of thing people say.

Placeholder — the format only, not a real quote. A real entry is a sentence somebody actually wrote, in a public discussion, with a link to that discussion.

DiscussionQuoteLink
example onlythe shape of a real quote, from a real public discussionlink to the discussion

The row above is a placeholder. It is not a quote from anybody. There are no quotes yet — the first discussions are the ones that will fill this.

How to help the project

The project is small, and the useful contributions are unglamorous. Here is what helps.

Star it

A star says the project is worth keeping an eye on. It is the cheapest thing to do and it helps somebody find it.

Use it in a project

Point a suite at the mocks and open a pull request adding yourself to the adopters list. A working example is worth more than a description of one.

Open an issue

Report something that does not do what it should. A mock that is wrong is worse than a mock that is missing, because a test will trust it.

Add a mock

The shape of a provider's API is in the provider's own documentation. Give the mock the routes it really has and the state it really keeps, register it in src/index.js with a port, a category and a description, and add a test.

Add a spec

A route file in contrib/ is enough for a service that is only read from. It is JSON, it needs no dependency, and it does not have to be reviewed as JavaScript.

Refresh a specification

The specifications the mocks are checked against are fetched from the providers' own repositories by a scheduled job. If one of them has moved, that is worth knowing.

The house rules are short: no new dependencies, the provider's real shapes, and a test that would fail without your change. The contributing guide has the rest, and the contributing folder has the route-file rules.

← Offline testing Home →