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.34 (2025-05-03)

Bug Fixes

• Update dependencies (#3584) (119fa4e)

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/commons

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/commons

5.0.29 (2024-07-10)

Note: Version bump only for package @feathersjs/commons

5.0.28 (2024-07-10)

Note: Version bump only for package @feathersjs/commons

5.0.27 (2024-06-18)

Note: Version bump only for package @feathersjs/commons

5.0.26 (2024-06-09)

Note: Version bump only for package @feathersjs/commons

5.0.25 (2024-05-03)

Note: Version bump only for package @feathersjs/commons

5.0.24 (2024-03-13)

Note: Version bump only for package @feathersjs/commons

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/commons

5.0.21 (2024-01-25)

Note: Version bump only for package @feathersjs/commons

5.0.20 (2024-01-24)

Note: Version bump only for package @feathersjs/commons

5.0.19 (2024-01-23)

Note: Version bump only for package @feathersjs/commons

5.0.18 (2024-01-22)

Note: Version bump only for package @feathersjs/commons

5.0.17 (2024-01-22)

Note: Version bump only for package @feathersjs/commons

5.0.16 (2024-01-22)

Note: Version bump only for package @feathersjs/commons

5.0.15 (2024-01-22)

Note: Version bump only for package @feathersjs/commons

5.0.14 (2024-01-05)

Note: Version bump only for package @feathersjs/commons

5.0.13 (2023-12-29)

Note: Version bump only for package @feathersjs/commons

5.0.12 (2023-11-28)

Note: Version bump only for package @feathersjs/commons

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/commons

5.0.9 (2023-09-27)

Note: Version bump only for package @feathersjs/commons

5.0.8 (2023-07-19)

Note: Version bump only for package @feathersjs/commons

5.0.7 (2023-07-14)

Note: Version bump only for package @feathersjs/commons

5.0.6 (2023-06-15)

Note: Version bump only for package @feathersjs/commons

5.0.5 (2023-04-28)

Note: Version bump only for package @feathersjs/commons

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)

Bug Fixes

• core: Use Symbol.for to instantiate shared symbols (#3087) (7f3fc21)

5.0.0 (2023-02-24)

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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/commons

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

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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/commons

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/commons

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

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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

Bug Fixes

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

Features

• dependencies: Remove direct debug dependency (#2296) (501d416)

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

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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)

Features

• core: Migrate @feathersjs/feathers to TypeScript (#1963) (7812529)
• core: use @feathers/hooks and add async type (#1929) (a5c4756)

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

Features

• core: Migrate @feathersjs/feathers to TypeScript (#1963) (7812529)
• core: use @feathers/hooks and add async type (#1929) (a5c4756)

4.5.11 (2020-12-05)

Note: Version bump only for package @feathersjs/commons

4.5.10 (2020-11-08)

Note: Version bump only for package @feathersjs/commons

4.5.9 (2020-10-09)

Note: Version bump only for package @feathersjs/commons

4.5.8 (2020-08-12)

Note: Version bump only for package @feathersjs/commons

4.5.7 (2020-07-24)

Note: Version bump only for package @feathersjs/commons

4.5.5 (2020-07-11)

Note: Version bump only for package @feathersjs/commons

4.5.3 (2020-04-17)

Note: Version bump only for package @feathersjs/commons

4.5.2 (2020-03-04)

Note: Version bump only for package @feathersjs/commons

4.5.1 (2020-01-24)

Note: Version bump only for package @feathersjs/commons

4.5.0 (2020-01-18)

Note: Version bump only for package @feathersjs/commons

4.4.3 (2019-12-06)

Note: Version bump only for package @feathersjs/commons

4.4.1 (2019-11-27)

Note: Version bump only for package @feathersjs/commons

4.3.7 (2019-10-14)

Bug Fixes

• make __hooks writable and configurable (#1520) (1c6c374)

4.3.0 (2019-08-27)

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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

Bug Fixes

• Update all dependencies (7d53a00)

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

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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

Note: Version bump only for package @feathersjs/commons

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

Bug Fixes

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

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

Bug Fixes

• Make Mocha a proper devDependency for every repository (#1053) (9974803)
• Update all dependencies to latest (#1206) (e51e0f6)
• use minimal RegExp matching for better performance (#977) (3ca7e97)

Features

• Add TypeScript definitions (#1275) (9dd6713)
• Common database adapter utilities and test suite (#1130) (17b3dc8)
• Remove (hook, next) signature and SKIP support (#1269) (211c0f8)

BREAKING CHANGES

• Move database adapter utilities from @feathersjs/commons into its own module

4.0.0 (2018-12-16)

Bug Fixes

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

Features

• Common database adapter utilities and test suite (#1130) (17b3dc8)

BREAKING CHANGES

• Move database adapter utilities from @feathersjs/commons into its own module

3.0.1 (2018-09-17)

Bug Fixes

• use minimal RegExp matching for better performance (#977) (3ca7e97)

Change Log

v3.0.0-pre.1 (2018-08-13)

Full Changelog

Merged pull requests:

• Remove argument verification and add further utilities #81 (daffl)

v2.0.0 (2018-08-03)

Full Changelog

Merged pull requests:

• Merge major with latest changes #80 (daffl)
• Ability to specify custom filters in filterQuery #73 (vonagam)

v1.4.4 (2018-08-01)

Full Changelog

v1.4.3 (2018-07-25)

Full Changelog

Merged pull requests:

• Revert breaking change from 78d780de91ae8333f3843be153beb5deea55c792 #78 (daffl)

v1.4.2 (2018-07-25)

Full Changelog

Closed issues:

• Sort error on multiple fields #74
• Cannot build with create-react-app (again) #71

Merged pull requests:

• Update all dependencies #77 (daffl)
• Use sorting algorithm from NeDB #76 (daffl)
• Open hook workflow to custom methods #72 (bertho-zero)

v1.4.1 (2018-04-12)

Full Changelog

Closed issues:

• Uncaught ReferenceError: convertGetOrRemove is not defined #69
• Cannot build with create-react-app #68

Merged pull requests:

• Make conversion functions more concise #70 (daffl)
• Update mocha to the latest version 🚀 #67 (greenkeeper[bot])

v1.4.0 (2018-01-17)

Full Changelog

Merged pull requests:

• Add ability to skip all following hooks #65 (sylvainlap)

v1.3.1 (2018-01-12)

Full Changelog

Merged pull requests:

• Allow array for sorting #66 (daffl)
• Update semistandard to the latest version 🚀 #64 (greenkeeper[bot])

v1.3.0 (2017-11-20)

Full Changelog

Merged pull requests:

• Add a toJSON method to the hook context #63 (daffl)
• updating contributing guide and issue template #61 (ekryski)

v1.2.0 (2017-10-25)

Full Changelog

Merged pull requests:

• Bring back makeUrl #62 (daffl)
• adding codeclimate config #60 (ekryski)

v1.1.0 (2017-10-23)

Full Changelog

Merged pull requests:

• Remove unused utilities and add some inline documentation #59 (daffl)
• Add feathers-query-filters #58 (daffl)

v1.0.0 (2017-10-19)

Full Changelog

Merged pull requests:

• Rename repository and add to npm scope #57 (daffl)
• Updates for Feathers v3 (Buzzard) #56 (daffl)

v1.0.0-pre.3 (2017-10-18)

Full Changelog

Merged pull requests:

• Update the client test suite #55 (daffl)
• Update mocha to the latest version 🚀 #54 (greenkeeper[bot])

v1.0.0-pre.2 (2017-07-11)

Full Changelog

Merged pull requests:

• Update to new plugin infrastructure #53 (daffl)

v1.0.0-pre.1 (2017-06-28)

Full Changelog

Merged pull requests:

• Commons for Feathers v3 #52 (daffl)
• Update chai to the latest version 🚀 #51 (greenkeeper[bot])
• Update semistandard to the latest version 🚀 #50 (greenkeeper[bot])
• Update dependencies to enable Greenkeeper 🌴 #49 (greenkeeper[bot])

v0.8.7 (2016-11-30)

Full Changelog

Closed issues:

• Matcher function blows up with null values #46

Merged pull requests:

• matcher now doesn't blow up with null values. Closes #46 #47 (ekryski)

v0.8.6 (2016-11-25)

Full Changelog

Merged pull requests:

• Allow to pass an object to hook object #45 (daffl)

v0.8.5 (2016-11-19)

Full Changelog

Merged pull requests:

• Deep merge and toObject #44 (ekryski)
• Expose lodash functions #43 (ekryski)
• Make url #42 (ekryski)
• Expect syntax #41 (ekryski)

v0.8.4 (2016-11-11)

Full Changelog

v0.8.3 (2016-11-11)

Full Changelog

v0.8.2 (2016-11-11)

Full Changelog

Merged pull requests:

• One more fix for select on arrays #40 (daffl)

v0.8.1 (2016-11-11)

Full Changelog

Merged pull requests:

• Fixing select utility methods to work with query selector #39 (daffl)

v0.8.0 (2016-11-09)

Full Changelog

Merged pull requests:

• Implementing lodash utilities and helpers for selecting #38 (daffl)
• jshint —> semistandard #37 (corymsmith)

v0.7.8 (2016-10-21)

Full Changelog

Merged pull requests:

• Make getting the service in base test dynamic #36 (daffl)

v0.7.7 (2016-10-21)

Full Changelog

Merged pull requests:

• Allow app in hookObject #35 (daffl)

v0.7.6 (2016-10-20)

Full Changelog

Merged pull requests:

• Add test for matching and increase code coverage #34 (daffl)
• omit '$select' in matcher #33 (beeplin)
• adding code coverage #32 (ekryski)

v0.7.5 (2016-09-05)

Full Changelog

Closed issues:

• Feathers should accept other type of data beside only the object type. #26
• Send better error messages for method normalization #12

Merged pull requests:

• Allow matching nested $or queries #29 (daffl)
• Add default export to hooks.js #28 (KenanY)
• Update mocha to version 3.0.0 🚀 #27 (greenkeeperio-bot)

v0.7.4 (2016-05-29)

Full Changelog

Merged pull requests:

• Use forEach instead of ES6 'for of' loop #25 (lopezjurip)
• mocha@2.5.0 breaks build 🚨 #24 (greenkeeperio-bot)
• Update babel-plugin-add-module-exports to version 0.2.0 🚀 #23 (greenkeeperio-bot)

v0.7.3 (2016-05-05)

Full Changelog

Merged pull requests:

• Make sure arguments from hook objects are created properly for known … #22 (daffl)

v0.7.2 (2016-04-26)

Full Changelog

Merged pull requests:

• Update test fixture to use promises and add error cases #19 (daffl)

v0.7.1 (2016-04-04)

Full Changelog

Merged pull requests:

• Adding functionality and tests for shared query and list handling #17 (daffl)

v0.6.2 (2016-02-09)

Full Changelog

v0.7.0 (2016-02-08)

Full Changelog

v0.6.1 (2016-02-08)

Full Changelog

Merged pull requests:

• Add NSP check to test script. #16 (marshallswain)

v0.6.0 (2016-01-21)

Full Changelog

Closed issues:

• Rename hooks to hookUtils to make room for common hooks. #13

Merged pull requests:

• Remove shared socket functionality #15 (daffl)
• Support socket routes with apps mounted on a path #14 (daffl)

v0.5.0 (2016-01-10)

Full Changelog

v0.4.0 (2016-01-10)

Full Changelog

v0.3.4 (2016-01-06)

Full Changelog

Merged pull requests:

• Fix SocketIO client iteration for all cases #11 (daffl)

v0.3.3 (2016-01-06)

Full Changelog

Closed issues:

• Socket.io 1.4.0 broke feathers #10

v0.3.2 (2016-01-06)

Full Changelog

v0.3.1 (2016-01-06)

Full Changelog

v0.3.0 (2015-12-11)

Full Changelog

Closed issues:

• babel inside package.json breaks react-native #9

v0.2.11 (2015-11-30)

Full Changelog

Merged pull requests:

• getOrRemove did not check id property type #8 (daffl)

v0.2.10 (2015-11-28)

Full Changelog

Closed issues:

• Remove dependency on lodash #6

Merged pull requests:

• Migrate to Babel 6 and remove Lodash dependency #7 (daffl)

v0.2.9 (2015-11-17)

Full Changelog

Closed issues:

• Event dispatcher context is not being set to the service #5
• .create with no callback throws error #4

v0.2.8 (2015-10-06)

Full Changelog

Closed issues:

• getArguments not exporting correctly #1

Merged pull requests:

• Add hookObject utilities and remove Lodash dependency from arguments.js #3 (daffl)

v0.2.7 (2015-03-07)

Full Changelog

v0.2.6 (2015-03-06)

Full Changelog

v0.2.5 (2015-03-06)

Full Changelog

0.2.3 (2015-03-06)

Full Changelog

0.2.2 (2015-03-06)

Full Changelog

0.2.1 (2015-03-06)

Full Changelog

0.2.0 (2015-03-06)

Full Changelog

0.1.0 (2015-03-06)

* _This Change Log was automatically generated by github_changelog_generator_