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.
| Who | What it is used for | Since |
|---|---|---|
| Example Co | Offline payment testing | add 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.
| Where | What it says | Link |
|---|---|---|
| example only | an example of a post about the project | link 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.
| Discussion | Quote | Link |
|---|---|---|
| example only | the shape of a real quote, from a real public discussion | link 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.