Fishery
github.com
- Free plan
What Fishery is
Fishery is a free JavaScript library for preparing objects as test data and for other situations where JavaScript data needs setup. Its factories define default values, while build() creates objects with supplied parameters layered over those defaults. TypeScript users can work with typed factory parameters and return objects, and the library can also be used without TypeScript. Factories may define onCreate behavior for asynchronous operations, so create() performs that work and returns a promise. Other capabilities include sequences, transient parameters, associations, and hooks that run after building or creating an object. Developers can extend factories with reusable builder methods by subclassing Factory, and use factories alongside others to build associated objects. Installation is documented for npm and Yarn as development dependencies. The repository identifies Fishery as MIT-licensed free software, maintained and funded by thoughtbot, inc., with GitHub Issues for bugs and change requests.
Who it suits
Fishery suits JavaScript and TypeScript developers setting up data for tests or related development tasks. It is useful when reusable factories and associations are needed.
Good to know, and what to watch
- Free software under the MIT license
- Works with or without TypeScript
- Supports asynchronous object creation
- Includes sequences and transient parameters
- Allows reusable builder methods
- Focused on JavaScript data setup
- Security policy details are not provided
Plans
Every plan and priceFree
Free plan
The verdict
Fishery offers factory-based object creation with typed support, asynchronous hooks and reusable builders. Its free MIT licence makes it a practical development dependency for test data preparation.
What the maker publishes
- Async creation
- Factories can use create() for asynchronous operations, with behavior configured through onCreate. source
- Audience
- The README describes Fishery as useful for tests and other situations where JavaScript data needs to be set up. source
- Build objects
- Factories provide build() to create objects, with passed parameters overlaid on factory defaults. source
- Build objects
- Factories use build() to create objects, and passed parameters overlay the factory's default properties. source
- Create objects
- Factories can define onCreate behavior so create() performs asynchronous work and returns a promise. source
- Factory features
- Factories support sequences, transient parameters, associations, and after-build and after-create hooks. source
- Factory features
- The README documents sequences, transient parameters, associations, after-build hooks, and after-create hooks. source
- Install
- The README gives npm install --save-dev fishery and yarn add --dev fishery as installation commands. source
- Installation
- The README gives npm and Yarn commands for installing Fishery as a development dependency. source
- Integration
- The README describes using factories alongside other factories to build associated objects. source
- Intended use
- The README says Fishery can be used in tests and anywhere else data needs to be set up. source
- License
- The repository identifies Fishery as free software and provides an MIT license. source
- License
- The README describes Fishery as free software and links to its license. source
- License details
- The repository identifies its license as MIT. source
- Maintainer
- The repository says it is maintained and funded by thoughtbot, inc. source
- Maintainer
- The repository says it is maintained and funded by thoughtbot, inc. source
- Purpose
- Fishery is a JavaScript library for setting up objects as test data. source
- Purpose
- Fishery is a JavaScript library for setting up objects for tests and other data needs. source
- Reusable builders
- The documentation describes extending factories with reusable builder methods by subclassing Factory. source
- Reusable builders
- Factories can be extended with methods to create reusable builder patterns. source
- Security
- The repository lists a security policy resource, but the opened page did not provide policy details. source
- Support channel
- The repository links to GitHub Issues for reporting bugs and requesting changes. source
- TypeScript
- Fishery supports typed factory parameters and return objects, and can also be used without TypeScript. source
- TypeScript
- Factories accept typed parameters and return typed objects, and Fishery also works without TypeScript. source
Checked against the maker's pages on 11 Oct 2026.