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

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

5.0.29 (2024-07-10)

Note: Version bump only for package @feathersjs/memory

5.0.28 (2024-07-10)

Note: Version bump only for package @feathersjs/memory

5.0.27 (2024-06-18)

Note: Version bump only for package @feathersjs/memory

5.0.26 (2024-06-09)

Note: Version bump only for package @feathersjs/memory

5.0.25 (2024-05-03)

Note: Version bump only for package @feathersjs/memory

5.0.24 (2024-03-13)

Note: Version bump only for package @feathersjs/memory

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

5.0.21 (2024-01-25)

Note: Version bump only for package @feathersjs/memory

5.0.20 (2024-01-24)

Note: Version bump only for package @feathersjs/memory

5.0.19 (2024-01-23)

Note: Version bump only for package @feathersjs/memory

5.0.18 (2024-01-22)

Note: Version bump only for package @feathersjs/memory

5.0.17 (2024-01-22)

Note: Version bump only for package @feathersjs/memory

5.0.16 (2024-01-22)

Note: Version bump only for package @feathersjs/memory

5.0.15 (2024-01-22)

Note: Version bump only for package @feathersjs/memory

5.0.14 (2024-01-05)

Note: Version bump only for package @feathersjs/memory

5.0.13 (2023-12-29)

Note: Version bump only for package @feathersjs/memory

5.0.12 (2023-11-28)

Bug Fixes

• allow _patch to modify the entire base schema (#3300) (0f41622)

5.0.11 (2023-10-11)

Bug Fixes

• knex: Update all dependencies and Knex peer (#3308) (d2f9860)
• memory: Ensure correct pagination totals (#3307) (c59e1b8)

5.0.10 (2023-10-03)

Note: Version bump only for package @feathersjs/memory

5.0.9 (2023-09-27)

Note: Version bump only for package @feathersjs/memory

5.0.8 (2023-07-19)

Note: Version bump only for package @feathersjs/memory

5.0.7 (2023-07-14)

Note: Version bump only for package @feathersjs/memory

5.0.6 (2023-06-15)

Note: Version bump only for package @feathersjs/memory

5.0.5 (2023-04-28)

Note: Version bump only for package @feathersjs/memory

5.0.4 (2023-04-12)

Bug Fixes

• Make sure all Readme files are up to date (#3154) (a5f0b38)
• memory: Fix memory adapter readme (#3153) (a9d826a)

5.0.3 (2023-04-05)

Bug Fixes

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

5.0.1 (2023-03-15)

Bug Fixes

• memory/mongodb: $select as only property & force 'id' in '$select' (#3081) (fbe3cf5)

5.0.0 (2023-02-24)

Note: Version bump only for package @feathersjs/memory

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

Note: Version bump only for package @feathersjs/memory

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

Note: Version bump only for package @feathersjs/memory

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

Note: Version bump only for package @feathersjs/memory

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)

Features

• adapter: Add patch data type to adapters and refactor AdapterBase usage (#2906) (9ddc2e6)

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

Bug Fixes

• memory: Use for loop in _find() for better performance (#2844) (d6ee5f1)

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

Note: Version bump only for package @feathersjs/memory

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

Features

• cli: Generate full client test suite and improve typed client (#2788) (57119b6)

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

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

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

Note: Version bump only for package @feathersjs/memory

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

Note: Version bump only for package @feathersjs/memory

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

Features

• cli: Initial Feathers v5 CLI and Pinion generator (#2578) (7f59ae7)

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

Note: Version bump only for package @feathersjs/memory

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

Note: Version bump only for package @feathersjs/memory

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

Note: Version bump only for package @feathersjs/memory

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)

Bug Fixes

• adapter-commons: Clarify adapter query filtering (#2607) (2dac771)

Features

• mongodb: Add feathers-mongodb adapter as @feathersjs/mongodb (#2610) (6d43734)
• typescript: Improve adapter typings (#2605) (3b2ca0a)
• typescript: Improve params and query typeability (#2600) (df28b76)

BREAKING CHANGES

• adapter-commons: Changes the common adapter base class to use sanitizeQuery and sanitizeData

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

Bug Fixes

• adapter-tests: Add tests for pagination in multi updates (#2472) (98a811a)

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

Note: Version bump only for package @feathersjs/memory

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

Note: Version bump only for package @feathersjs/memory

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

Note: Version bump only for package @feathersjs/memory

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

Note: Version bump only for package @feathersjs/memory

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

Note: Version bump only for package @feathersjs/memory

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

Note: Version bump only for package @feathersjs/memory

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

Note: Version bump only for package @feathersjs/memory

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

Features

• schema: Initial version of schema definitions and resolvers (#2441) (c57a5cd)

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

Note: Version bump only for package @feathersjs/memory

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

Note: Version bump only for package @feathersjs/memory

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

Note: Version bump only for package @feathersjs/memory

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

Note: Version bump only for package @feathersjs/memory

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

Bug Fixes

• Update database adapter common repository urls (#2380) (3f4db68)

Features

• adapter-commons: Add support for params.adapter option and move memory adapter to @feathersjs/memory (#2367) (a43e7da)
• typescript: Allow to pass generic service options to adapter services (#2392) (f9431f2)

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

Features

• koa: KoaJS transport adapter (#2315) (2554b57)

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

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

Note: Version bump only for package @feathersjs/memory

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

Bug Fixes

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

Features

• Feathers v5 core refactoring and features (#2255) (2dafb7c)

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

Features

• memory: Move feathers-memory into @feathersjs/memory (#2153) (dd61fe3)

Change Log

v4.1.0 (2019-10-07)

Full Changelog

Merged pull requests:

• Update all dependencies #104 (daffl)

v4.0.1 (2019-09-29)

Full Changelog

Closed issues:

• An in-range update of @types/node is breaking the build 🚨 #101
• An in-range update of webpack is breaking the build 🚨 #98

Merged pull requests:

• Pass entity type to AdapterService<T> #103 (daffl)
• Update semistandard to the latest version 🚀 #102 (greenkeeper[bot])
• Update dtslint to the latest version 🚀 #100 (greenkeeper[bot])
• Greenkeeper/webpack 4.36.1 #99 (daffl)

v4.0.0 (2019-07-05)

Full Changelog

Merged pull requests:

• Add TypeScript definitions and upgrade to Feathers 4 #97 (daffl)
• Update mocha to the latest version 🚀 #94 (greenkeeper[bot])

v3.0.2 (2019-01-24)

Full Changelog

Closed issues:

• Multiple patch records #92

Merged pull requests:

• Allow patch to update prop that is within the query #93 (Mattchewone)
• Add new tests #91 (daffl)
• Update @feathersjs/adapter-commons to the latest version 🚀 #90 (greenkeeper[bot])

v3.0.1 (2018-12-29)

Full Changelog

Merged pull requests:

• Add default params to hook-less methods #89 (daffl)

v3.0.0 (2018-12-17)

Full Changelog

Closed issues:

• An in-range update of webpack is breaking the build 🚨 #84
• An in-range update of @feathersjs/errors is breaking the build 🚨 #83

Merged pull requests:

• Update to @feathersjs/adapter-commons and drop Node 6 #88 (daffl)
• Update semistandard to the latest version 🚀 #87 (greenkeeper[bot])
• Update all dependencies and Webpack build #85 (daffl)
• Update babel-loader to the latest version 🚀 #81 (greenkeeper[bot])

v2.2.0 (2018-08-26)

Full Changelog

Closed issues:

• Previously functional batch service no longer works when creating in-memory service #77

Merged pull requests:

• Remove cloneDeep dependency #80 (daffl)
• Fix cloning of instances #79 (homerjam)
• Update sift to the latest version 🚀 #76 (greenkeeper[bot])

v2.1.3 (2018-06-11)

Full Changelog

Closed issues:

• Use with create-react-app #74

Merged pull requests:

• Transpile all Feathers modules for distributable #75 (saiichihashimoto)
• Update shx to the latest version 🚀 #73 (greenkeeper[bot])

v2.1.2 (2018-06-03)

Full Changelog

Merged pull requests:

• Update uberproto to the latest version 🚀 #72 (greenkeeper[bot])
• Update clone-deep to the latest version 🚀 #70 (greenkeeper[bot])

v2.1.1 (2018-03-07)

Full Changelog

Closed issues:

• Why are all the data deleted after the server is rebooted? #68

Merged pull requests:

• Update webpack to the latest version 🚀 #69 (greenkeeper[bot])
• Update clone-deep to the latest version 🚀 #67 (greenkeeper[bot])
• Update mocha to the latest version 🚀 #66 (greenkeeper[bot])
• Update semistandard to the latest version 🚀 #65 (greenkeeper[bot])

v2.1.0 (2017-12-03)

Full Changelog

Merged pull requests:

• Use namespaced module name for exporting #64 (daffl)

v2.0.0 (2017-12-03)

Full Changelog

Merged pull requests:

• Client build #63 (daffl)
• Upgrade to Feathers Buzzard (v3) #62 (daffl)
• Update to new plugin infrastructure #61 (daffl)
• Update clone-deep to the latest version 🚀 #60 (greenkeeper[bot])

v1.3.1 (2017-10-20)

Full Changelog

Closed issues:

• Custom $select returning id #58
• Best practice for $search #51

Merged pull requests:

• Do not select the id by default #59 (daffl)

v1.3.0 (2017-10-19)

Full Changelog

Merged pull requests:

• Modified matcher to use new sift package #57 (Mattchewone)
• Update mocha to the latest version 🚀 #56 (greenkeeper[bot])

v1.2.1 (2017-09-13)

Full Changelog

v1.2.0 (2017-09-13)

Full Changelog

Closed issues:

• [RFE] An option to set the type of the id field to String #54

Merged pull requests:

• Deep clone objects before returning #55 (daffl)
• Update feathers-socketio to the latest version 🚀 #52 (greenkeeper[bot])
• Update feathers-service-tests to the latest version 🚀 #50 (greenkeeper[bot])
• Update semistandard to the latest version 🚀 #49 (greenkeeper[bot])
• Update dependencies to enable Greenkeeper 🌴 #48 (greenkeeper[bot])

v1.1.0 (2017-01-31)

Full Changelog

Merged pull requests:

• Allow to pass a custom matcher and sorter in the options #47 (daffl)
• Change var to const, fix a mistake with feathers-memory requiring #46 (osenvosem)

v1.0.1 (2016-11-15)

Full Changelog

Merged pull requests:

• feathers-service-tests@0.9.1 breaks build 🚨 #45 (greenkeeperio-bot)

v1.0.0 (2016-11-11)

Full Changelog

Closed issues:

• Support $select for gets #35

Merged pull requests:

• Update feathers-service-tests to version 0.9.0 🚀 #44 (greenkeeperio-bot)
• Update feathers-commons to version 0.8.0 🚀 #43 (greenkeeperio-bot)

v0.8.1 (2016-11-02)

Full Changelog

Merged pull requests:

• fix $select with more than one field #42 (t2t2)
• babel-preset-es2015@6.18.0 breaks build 🚨 #41 (greenkeeperio-bot)
• Two tweaks for clean build and tests on Windows #38 (ghost)
• jshint —> semistandard #37 (marshallswain)
• adding code coverage reporting #36 (ekryski)
• Update feathers-service-tests to version 0.8.0 🚀 #32 (greenkeeperio-bot)

v0.8.0 (2016-09-08)

Full Changelog

Closed issues:

• Remove object from memory once sent? #30

Merged pull requests:

• Update service tests, id and events option #31 (greenkeeperio-bot)
• Update mocha to version 3.0.0 🚀 #29 (greenkeeperio-bot)

v0.7.5 (2016-07-25)

Full Changelog

v0.7.4 (2016-07-21)

Full Changelog

Merged pull requests:

• Update feathers-query-filters to version 2.0.0 🚀 #28 (greenkeeperio-bot)

v0.7.3 (2016-06-16)

Full Changelog

Merged pull requests:

• Update feathers-service-tests to version 0.6.0 🚀 #27 (greenkeeperio-bot)

v0.7.2 (2016-06-14)

Full Changelog

Closed issues:

• Support $search #14

Merged pull requests:

• Use the original id if it can be coerced #26 (daffl)
• mocha@2.5.0 breaks build 🚨 #25 (greenkeeperio-bot)
• Update babel-plugin-add-module-exports to version 0.2.0 🚀 #24 (greenkeeperio-bot)

v0.7.1 (2016-04-05)

Full Changelog

v0.7.0 (2016-04-04)

Full Changelog

Merged pull requests:

• Move to feathers-commons utilities #20 (daffl)

v0.6.3 (2016-02-25)

Full Changelog

Closed issues:

• Upgrade to lodash 4 #17

Merged pull requests:

• Use individual Lodash methods #19 (daffl)

v0.6.2 (2016-02-24)

Full Changelog

Merged pull requests:

• bumping feathers-errors version #16 (ekryski)

v0.6.1 (2016-02-22)

Full Changelog

Merged pull requests:

• Exmaple update #15 (ekryski)

v0.6.0 (2016-01-30)

Full Changelog

Merged pull requests:

• Use internal methods instead of service methods directly #13 (daffl)

v0.5.3 (2016-01-23)

Full Changelog

v0.5.2 (2016-01-23)

Full Changelog

Merged pull requests:

• Adding nsp check #12 (marshallswain)

v0.5.1 (2015-12-19)

Full Changelog

v0.5.0 (2015-12-03)

Full Changelog

v0.4.1 (2015-12-03)

Full Changelog

Merged pull requests:

• Use ES6 classes, Promises and support pagination #11 (daffl)

v0.4.0 (2015-11-07)

Full Changelog

Closed issues:

• How properly append values to an existing memory element #9
• how to initialize memory on app startup #8
• Add query-filter support #7
• Remove sorting and other processing from core service #4

Merged pull requests:

• Migrate to ES6 plugin infrastructure and shared feathers-service-tests #10 (daffl)
• Added support for simple query in find #6 (ruimgoncalves)

0.3.4 (2014-09-25)

Full Changelog

Closed issues:

• Query and persisting Data #5

0.3.3 (2014-06-13)

Full Changelog

0.3.2 (2014-06-13)

Full Changelog

0.3.1 (2014-06-13)

Full Changelog

Closed issues:

• Fix peer dependency #3
• Should support patch service method #2
• Need to return proper errors #1

0.3.0 (2014-06-05)

Full Changelog

0.2.1 (2014-06-04)

Full Changelog

0.2.0 (2014-04-22)

Full Changelog

0.1.2 (2014-04-11)

Full Changelog

0.1.1 (2014-04-11)

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