Feathers is a full-stack framework for creating web APIs and real-time applications with TypeScript or JavaScript.

Feathers can interact with any backend technology, supports many databases out of the box and works with any frontend like React, VueJS, Angular, React Native, Android or iOS.

Getting started

Get started with just three commands:

$ npm create feathers my-new-app
$ cd my-new-app
$ npm run dev

To learn more about Feathers visit the website at feathersjs.com or jump right into the Feathers guides.

Contributing

To start developing, clone this repository, then run:

cd feathers
npm install

To run all tests run

npm test

Individual tests can be run in the module you are working on:

cd packages/feathers
npm test

License

Copyright (c) 2024 Feathers contributors

Licensed under the MIT license.

Change Log

All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.

5.0.33 (2025-02-24)

Bug Fixes

• dependencies: Update dependencies (#3571) (ad611cb)

5.0.32 (2025-02-01)

Note: Version bump only for package @feathersjs/errors

5.0.31 (2024-10-31)

Bug Fixes

• dependencies: Update all dependencies (#3545) (221b92b)

5.0.30 (2024-09-02)

Note: Version bump only for package @feathersjs/errors

5.0.29 (2024-07-10)

Note: Version bump only for package @feathersjs/errors

5.0.28 (2024-07-10)

Note: Version bump only for package @feathersjs/errors

5.0.27 (2024-06-18)

Note: Version bump only for package @feathersjs/errors

5.0.26 (2024-06-09)

Note: Version bump only for package @feathersjs/errors

5.0.25 (2024-05-03)

Note: Version bump only for package @feathersjs/errors

5.0.24 (2024-03-13)

Note: Version bump only for package @feathersjs/errors

5.0.23 (2024-02-25)

Bug Fixes

• core: Update to latest feathersjs/hooks (#3434) (1499ccc)

5.0.22 (2024-02-15)

Note: Version bump only for package @feathersjs/errors

5.0.21 (2024-01-25)

Note: Version bump only for package @feathersjs/errors

5.0.20 (2024-01-24)

Note: Version bump only for package @feathersjs/errors

5.0.19 (2024-01-23)

Note: Version bump only for package @feathersjs/errors

5.0.18 (2024-01-22)

Note: Version bump only for package @feathersjs/errors

5.0.17 (2024-01-22)

Note: Version bump only for package @feathersjs/errors

5.0.16 (2024-01-22)

Note: Version bump only for package @feathersjs/errors

5.0.15 (2024-01-22)

Note: Version bump only for package @feathersjs/errors

5.0.14 (2024-01-05)

Note: Version bump only for package @feathersjs/errors

5.0.13 (2023-12-29)

Note: Version bump only for package @feathersjs/errors

5.0.12 (2023-11-28)

Note: Version bump only for package @feathersjs/errors

5.0.11 (2023-10-11)

Bug Fixes

• knex: Update all dependencies and Knex peer (#3308) (d2f9860)

5.0.10 (2023-10-03)

Note: Version bump only for package @feathersjs/errors

5.0.9 (2023-09-27)

Note: Version bump only for package @feathersjs/errors

5.0.8 (2023-07-19)

Note: Version bump only for package @feathersjs/errors

5.0.7 (2023-07-14)

Note: Version bump only for package @feathersjs/errors

5.0.6 (2023-06-15)

Note: Version bump only for package @feathersjs/errors

5.0.5 (2023-04-28)

Note: Version bump only for package @feathersjs/errors

5.0.4 (2023-04-12)

Bug Fixes

• Make sure all Readme files are up to date (#3154) (a5f0b38)

5.0.3 (2023-04-05)

Bug Fixes

• dependencies: Update all dependencies (#3139) (f24276e)

5.0.1 (2023-03-15)

Note: Version bump only for package @feathersjs/errors

5.0.0 (2023-02-24)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.38 (2023-02-17)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.37 (2023-02-09)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.36 (2023-01-29)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.35 (2023-01-12)

Features

• generators: Move core code generators to shared generators package (#2982) (0328d22)

5.0.0-pre.34 (2022-12-14)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.33 (2022-11-08)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.32 (2022-10-26)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.31 (2022-10-12)

Bug Fixes

• errors: Allows to pass no error message (#2794) (f3ddab6)

5.0.0-pre.30 (2022-10-07)

Features

• core: Allow to unregister services at runtime (#2756) (d16601f)

5.0.0-pre.29 (2022-09-16)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.28 (2022-08-03)

Bug Fixes

• cli: Improve generated application and client (#2701) (bd55ffb)

5.0.0-pre.27 (2022-07-13)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.26 (2022-06-22)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.25 (2022-06-22)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.24 (2022-06-21)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.23 (2022-06-06)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.22 (2022-05-24)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.21 (2022-05-23)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.20 (2022-05-04)

Bug Fixes

• dependencies: Lock monorepo package version numbers (#2623) (5640c10)

5.0.0-pre.19 (2022-05-01)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.18 (2022-04-11)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.17 (2022-02-15)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.16 (2022-01-12)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.15 (2021-11-27)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.14 (2021-10-13)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.13 (2021-10-13)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.12 (2021-10-12)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.11 (2021-10-06)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.10 (2021-09-19)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.9 (2021-08-09)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.8 (2021-08-09)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.7 (2021-08-09)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.6 (2021-08-08)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.5 (2021-06-23)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.4 (2021-05-13)

Note: Version bump only for package @feathersjs/errors

5.0.0-pre.3 (2021-04-21)

Bug Fixes

• typescript: Improve TypeScript backwards compatibility (#2310) (f33be73)

5.0.0-pre.2 (2021-04-06)

Note: Version bump only for package @feathersjs/errors

5.0.0-beta.1 (2021-04-03)

Note: Version bump only for package @feathersjs/errors

5.0.0-beta.0 (2021-03-28)

Bug Fixes

• Update Grant usage and other dependencies (#2264) (7b0f8fa)

5.0.0-pre.1 (2020-12-17)

5.0.0-pre.0 (2020-05-19)

Bug Fixes

• errors: Format package.json with spaces (cbd31c1)

5.0.0-pre.0 (2020-05-19)

Bug Fixes

• errors: Format package.json with spaces (cbd31c1)
• typescript: Fix data property definition in @feathersjs/errors (#2018) (ef1398c)

4.5.11 (2020-12-05)

Note: Version bump only for package @feathersjs/errors

4.5.10 (2020-11-08)

Note: Version bump only for package @feathersjs/errors

4.5.9 (2020-10-09)

Note: Version bump only for package @feathersjs/errors

4.5.8 (2020-08-12)

Note: Version bump only for package @feathersjs/errors

4.5.7 (2020-07-24)

Note: Version bump only for package @feathersjs/errors

4.5.5 (2020-07-11)

Note: Version bump only for package @feathersjs/errors

4.5.3 (2020-04-17)

Bug Fixes

• errors: Add 410 Gone to errors (#1849) (6801428)

4.5.2 (2020-03-04)

Note: Version bump only for package @feathersjs/errors

4.5.1 (2020-01-24)

Note: Version bump only for package @feathersjs/errors

4.5.0 (2020-01-18)

Note: Version bump only for package @feathersjs/errors

4.4.3 (2019-12-06)

Note: Version bump only for package @feathersjs/errors

4.4.1 (2019-11-27)

Note: Version bump only for package @feathersjs/errors

4.4.0 (2019-11-27)

Note: Version bump only for package @feathersjs/errors

4.3.11 (2019-11-11)

Note: Version bump only for package @feathersjs/errors

4.3.10 (2019-10-26)

Note: Version bump only for package @feathersjs/errors

4.3.9 (2019-10-26)

Bug Fixes

• Small type improvements (#1624) (50162c6)

4.3.7 (2019-10-14)

Note: Version bump only for package @feathersjs/errors

4.3.4 (2019-10-03)

Note: Version bump only for package @feathersjs/errors

4.3.3 (2019-09-21)

Note: Version bump only for package @feathersjs/errors

4.3.2 (2019-09-16)

Note: Version bump only for package @feathersjs/errors

4.3.1 (2019-09-09)

Note: Version bump only for package @feathersjs/errors

4.3.0 (2019-08-27)

Note: Version bump only for package @feathersjs/errors

4.3.0-pre.4 (2019-08-22)

Note: Version bump only for package @feathersjs/errors

4.3.0-pre.3 (2019-08-19)

Note: Version bump only for package @feathersjs/errors

4.3.0-pre.2 (2019-08-02)

Note: Version bump only for package @feathersjs/errors

4.3.0-pre.1 (2019-07-11)

Note: Version bump only for package @feathersjs/errors

4.0.0-pre.5 (2019-07-10)

Note: Version bump only for package @feathersjs/errors

4.0.0-pre.4 (2019-07-05)

Note: Version bump only for package @feathersjs/errors

4.0.0-pre.3 (2019-06-01)

Bug Fixes

• Update dependencies and fix tests (#1373) (d743a7f)

4.0.0-pre.2 (2019-05-15)

Bug Fixes

• Use export = in TypeScript definitions (#1285) (12d0f4b)

4.0.0-pre.1 (2019-05-08)

Bug Fixes

• Do not log as errors below a 500 response (#1256) (33fd0e4)

4.0.0-pre.0 (2019-04-21)

Bug Fixes

• Make Mocha a proper devDependency for every repository (#1053) (9974803)
• Update 401.html (#983) (cec6bae)
• Update 404.html (#984) (72132d1)
• Update adapter common tests (#1135) (8166dda)
• Update all dependencies to latest (#1206) (e51e0f6)
• compile-task: on windows machine (#60) (617e0a4)
• package: update debug to version 3.0.0 (#86) (fd1bb6b)

Features

• Add TypeScript definitions (#1275) (9dd6713)
• Authentication v3 core server implementation (#1205) (1bd7591)

3.3.6 (2019-01-02)

Bug Fixes

• Update adapter common tests (#1135) (8166dda)

3.3.5 (2018-12-16)

Bug Fixes

• Make Mocha a proper devDependency for every repository (#1053) (9974803)

3.3.4 (2018-09-21)

Note: Version bump only for package @feathersjs/errors

3.3.3 (2018-09-17)

Bug Fixes

• Update 401.html (#983) (cec6bae)
• Update 404.html (#984) (72132d1)

3.3.2 (2018-09-02)

Note: Version bump only for package @feathersjs/errors

3.3.1

• Migrate to Monorepo (feathers#462)

v3.3.0 (2018-02-12)

Full Changelog

Closed issues:

• How to handling error from Hook function when I use Aync/Await in Hook function #106

Merged pull requests:

• Add a verbose flag to notFound handler #107 (daffl)
• Add req.url to notFound handler message #105 (FreeLineTM)

v3.2.2 (2018-01-23)

Full Changelog

Closed issues:

• Handling Status Codes #103
• Override default error page #102
• wrong npm package in Installation instructions #100

Merged pull requests:

• Fix instanceof and prototypical inheritance #104 (nikaspran)
• Update mocha to the latest version 🚀 #101 (greenkeeper[bot])
• fix installation declaration #99 (jasonmacgowan)

v3.2.1 (2018-01-03)

Full Changelog

Closed issues:

• Error handler usage/setup is mis-documented #96

Merged pull requests:

• Update readme to correspond with latest release #98 (daffl)
• Update semistandard to the latest version 🚀 #97 (greenkeeper[bot])

v3.2.0 (2017-11-19)

Full Changelog

Merged pull requests:

• Allow ability to log middleware errors #95 (daffl)

v3.1.0 (2017-11-18)

Full Changelog

Closed issues:

• feature: allow for mixed files/functions for error-handler options #91

Merged pull requests:

• 91 allow mixed config #94 (DesignByOnyx)

v3.0.0 (2017-11-01)

Full Changelog

Merged pull requests:

• Update to Buzzard infrastructure #93 (daffl)

v3.0.0-pre.1 (2017-10-21)

Full Changelog

Closed issues:

• [Proposal] use verror #88

Merged pull requests:

• Update to new plugin infrastructure and npm scope #92 (daffl)
• Update mocha to the latest version 🚀 #90 (greenkeeper[bot])
• Update sinon to the latest version 🚀 #89 (greenkeeper[bot])

v2.9.2 (2017-09-05)

Full Changelog

Closed issues:

• Getting 500 status code when attempting to throw non 500 style errors (401) #85

Merged pull requests:

• fix typings #87 (j2L4e)
• Update debug to the latest version 🚀 #86 (greenkeeper[bot])
• Update sinon to the latest version 🚀 #84 (greenkeeper[bot])

v2.9.1 (2017-07-21)

Full Changelog

Merged pull requests:

• Add back default error message #83 (daffl)

v2.9.0 (2017-07-20)

Full Changelog

Closed issues:

• Wrong stack for errors #78

Merged pull requests:

• Capture proper stack trace and error messages #82 (daffl)
• Update chai to the latest version 🚀 #81 (greenkeeper[bot])

v2.8.2 (2017-07-05)

Full Changelog

Merged pull requests:

• Fix wildcard import on ES2015+ #80 (coreh)
• Add more information to error debug #79 (kamzil)

v2.8.1 (2017-05-30)

Full Changelog

Merged pull requests:

• Fix errors property being lost when cloning #76 (0x6431346e)

v2.8.0 (2017-05-08)

Full Changelog

Closed issues:

• Support array objects as data #64

Merged pull requests:

• Allow data to be an array #75 (0x6431346e)

v2.7.1 (2017-04-28)

Full Changelog

Closed issues:

• Object.setPrototypeOf in IE 10 #70

Merged pull requests:

• Define property toJSON because just assigning it throws an error in N… #74 (daffl)

v2.7.0 (2017-04-25)

Full Changelog

Merged pull requests:

• Change back to old Error inheritance #73 (daffl)
• Update semistandard to the latest version 🚀 #72 (greenkeeper[bot])
• Update dependencies to enable Greenkeeper 🌴 #71 (greenkeeper[bot])

v2.6.3 (2017-04-08)

Full Changelog

Closed issues:

• Make options the same as res.format #37

Merged pull requests:

• fix typescript definitions with noImplicitAny #69 (JVirant)

v2.6.2 (2017-03-16)

Full Changelog

Closed issues:

• Create a TokenExpired error type #53

Merged pull requests:

• Fix declarations for index.d.ts #66 (ghost)

v2.6.1 (2017-03-06)

Full Changelog

Merged pull requests:

• fix pull request #62 #63 (superbarne)

v2.6.0 (2017-03-04)

Full Changelog

Closed issues:

• Full Validation Error Object not passed to client promise #61
• More HTTP Statuses #48

Merged pull requests:

• add typescript definitions #62 (superbarne)
• Fix compile npm task on Windows #60 (AbraaoAlves)

v2.5.0 (2016-11-04)

Full Changelog

Closed issues:

• Possible issue with Node 4 #51
• Consider using restify/errors as base #31

Merged pull requests:

• Adding more error types #55 (franciscofsales)
• 👻😱 Node.js 0.10 is unmaintained 😱👻 #54 (greenkeeperio-bot)
• jshint —> semistandard #52 (corymsmith)
• Update mocha to version 3.0.0 🚀 #47 (greenkeeperio-bot)

v2.4.0 (2016-07-17)

Full Changelog

Merged pull requests:

• adding ability to get a feathers error by http status code #46 (ekryski)

v2.3.0 (2016-07-10)

Full Changelog

Closed issues:

• Heroku error Reflect.construct #44

Merged pull requests:

• Not found #45 (ekryski)

v2.2.0 (2016-05-27)

Full Changelog

Closed issues:

• Can not format error to json #35

Merged pull requests:

• Add an error conversion method #43 (daffl)
• mocha@2.5.0 breaks build 🚨 #42 (greenkeeperio-bot)
• Update babel-plugin-add-module-exports to version 0.2.0 🚀 #41 (greenkeeperio-bot)

v2.1.0 (2016-04-03)

Full Changelog

Closed issues:

• Support passing a custom html format function #32

Merged pull requests:

• Custom handlers #36 (ekryski)
• Update all dependencies 🌴 #34 (greenkeeperio-bot)

v2.0.2 (2016-03-23)

Full Changelog

Closed issues:

• ReferenceError: Reflect is not defined #29
• Make error pages opt-in #24

Merged pull requests:

• Update package.json #33 (marshallswain)
• Fixed typo #30 (kulakowka)

v2.0.1 (2016-02-24)

Full Changelog

Closed issues:

• Error handler is wrapping errors as GeneralErrors #27

Merged pull requests:

• adding an explicit error type #28 (ekryski)

v2.0.0 (2016-02-24)

Full Changelog

Merged pull requests:

• move error handler out of index #26 (ekryski)

v1.2.4 (2016-02-24)

Full Changelog

v1.2.3 (2016-02-21)

Full Changelog

Merged pull requests:

• Adding default error page and make HTML formatting optional #25 (daffl)

v1.2.2 (2016-02-18)

Full Changelog

Closed issues:

• Add error handler back #21

Merged pull requests:

• Make fully CommonJS compatible and add error middleware tests #23 (daffl)

v1.2.1 (2016-02-16)

Full Changelog

v1.2.0 (2016-02-15)

Full Changelog

Closed issues:

• Check to make sure that errors propagate via web sockets #1

Merged pull requests:

• adding error handler back #22 (ekryski)

v1.1.6 (2016-01-12)

Full Changelog

Closed issues:

• stacktraces are incorrect when used in an ES6 app #20
• We shouldn't mutate the error object passed in. #19
• only one instance of babel-polyfill is allowed #17

v1.1.5 (2015-12-18)

Full Changelog

v1.1.4 (2015-12-15)

Full Changelog

Closed issues:

• no method 'setPrototypeOf' in Node 0.10 #16

v1.1.3 (2015-12-15)

Full Changelog

v1.1.2 (2015-12-15)

Full Changelog

Closed issues:

• Passing errors as second argument #9

v1.1.1 (2015-12-14)

Full Changelog

Closed issues:

• Subclassing Errors using babel don't behave as expected #14

Merged pull requests:

• Es6 class fix #15 (ekryski)

v1.1.0 (2015-12-12)

Full Changelog

v1.0.0 (2015-12-12)

Full Changelog

Closed issues:

• Convert to ES6 #12
• Drop the error handlers: Breaking Change #11
• Remove Lodash dependency #10
• Logging only unhandled errors #8

Merged pull requests:

• complete rewrite. Closes #11 and #12. #13 (ekryski)

0.2.5 (2015-02-05)

Full Changelog

0.2.4 (2015-02-05)

Full Changelog

0.2.3 (2015-01-29)

Full Changelog

0.2.2 (2015-01-29)

Full Changelog

0.2.1 (2014-09-03)

Full Changelog

0.2.0 (2014-07-17)

Full Changelog

Implemented enhancements:

• Handle error objects with an 'errors' object #5

0.1.7 (2014-07-06)

Full Changelog

0.1.6 (2014-07-05)

Full Changelog

0.1.5 (2014-06-13)

Full Changelog

0.1.4 (2014-06-13)

Full Changelog

Closed issues:

• Move errors into core #2

Merged pull requests:

• Core compatible #4 (ekryski)

0.1.3 (2014-06-09)

Full Changelog

Merged pull requests:

• Adding a default error page #3 (ekryski)

0.1.2 (2014-06-05)

Full Changelog

0.1.1 (2014-06-04)

Full Changelog

v0.1.0 (2014-06-04)

* This Change Log was automatically generated by [githubchangelog_generator](https://github.com/skywinder/Github-Changelog-Generator)_