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

5.0.31 (2024-10-31)

Bug Fixes

• dependencies: Update all dependencies (#3545) (221b92b)
• express: Update express to version 4.21.1 (#3543) (56d6151)

5.0.30 (2024-09-02)

Note: Version bump only for package @feathersjs/express

5.0.29 (2024-07-10)

Note: Version bump only for package @feathersjs/express

5.0.28 (2024-07-10)

Note: Version bump only for package @feathersjs/express

5.0.27 (2024-06-18)

Note: Version bump only for package @feathersjs/express

5.0.26 (2024-06-09)

Note: Version bump only for package @feathersjs/express

5.0.25 (2024-05-03)

Bug Fixes

• Reduce usage of lodash (#3455) (8ce807a)

5.0.24 (2024-03-13)

Note: Version bump only for package @feathersjs/express

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

5.0.21 (2024-01-25)

Note: Version bump only for package @feathersjs/express

5.0.20 (2024-01-24)

Note: Version bump only for package @feathersjs/express

5.0.19 (2024-01-23)

Note: Version bump only for package @feathersjs/express

5.0.18 (2024-01-22)

Note: Version bump only for package @feathersjs/express

5.0.17 (2024-01-22)

Note: Version bump only for package @feathersjs/express

5.0.16 (2024-01-22)

Note: Version bump only for package @feathersjs/express

5.0.15 (2024-01-22)

Note: Version bump only for package @feathersjs/express

5.0.14 (2024-01-05)

Note: Version bump only for package @feathersjs/express

5.0.13 (2023-12-29)

Note: Version bump only for package @feathersjs/express

5.0.12 (2023-11-28)

Bug Fixes

• express: Re-export Router (#3349) (0cbdb03)

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

5.0.9 (2023-09-27)

Note: Version bump only for package @feathersjs/express

5.0.8 (2023-07-19)

Note: Version bump only for package @feathersjs/express

5.0.7 (2023-07-14)

Note: Version bump only for package @feathersjs/express

5.0.6 (2023-06-15)

Note: Version bump only for package @feathersjs/express

5.0.5 (2023-04-28)

Note: Version bump only for package @feathersjs/express

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

5.0.0 (2023-02-24)

Note: Version bump only for package @feathersjs/express

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

Note: Version bump only for package @feathersjs/express

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

Note: Version bump only for package @feathersjs/express

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

Bug Fixes

• Update all dependencies (#3024) (283dc47)

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)

Bug Fixes

• core: context.type for around hooks (#2890) (d606ac6)

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

Note: Version bump only for package @feathersjs/express

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

Bug Fixes

• docs: Review transport API docs and update Express middleware setup (#2811) (1b97f14)
• transports: Add remaining middleware for generated apps to Koa and Express (#2796) (0d5781a)

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

Note: Version bump only for package @feathersjs/express

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

Bug Fixes

• core: Ensure setup and teardown can be overriden and maintain hook functionality (#2779) (ab580cb)

Features

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

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

Features

• Add CORS support to oAuth, Express, Koa and generated application (#2744) (fd218f2)
• authentication-oauth: Koa and transport independent oAuth authentication (#2737) (9231525)

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

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

Note: Version bump only for package @feathersjs/express

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

Note: Version bump only for package @feathersjs/express

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

Bug Fixes

• authentication: Add safe dispatch data for authentication requests (#2662) (d8104a1)

Features

• cli: Add support for JavaScript to the new CLI (#2668) (ebac587)

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

Bug Fixes

• express: Ensure Express options can be set before configuring REST transport (#2655) (c9b8f74)

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

Note: Version bump only for package @feathersjs/express

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

Note: Version bump only for package @feathersjs/express

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

• express: Fix typo in types reference in package.json (#2613) (eacf1b3)

Features

• typescript: Improve params and query typeability (#2600) (df28b76)

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

Features

• core: Add app.teardown functionality (#2570) (fcdf524)
• core: Finalize app.teardown() functionality (#2584) (1a166f3)
• transport-commons: add context.http.response (#2524) (5bc9d44)

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

Bug Fixes

• express: Fix application typings to work with typed configuration (#2539) (b9dfaee)

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

Features

• express, koa: make transports similar (#2486) (26aa937)

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

Bug Fixes

• missing express types for Request, Response (#2498) (ee67131)
• typescript: Overall typing improvements (#2478) (b8eb804)

Features

• core: add context.http and move statusCode there (#2496) (b701bf7)
• core: Improve legacy hooks integration (08c8b40)

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

Note: Version bump only for package @feathersjs/express

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

Note: Version bump only for package @feathersjs/express

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

Note: Version bump only for package @feathersjs/express

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

Note: Version bump only for package @feathersjs/express

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

Note: Version bump only for package @feathersjs/express

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

Note: Version bump only for package @feathersjs/express

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

Note: Version bump only for package @feathersjs/express

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

Note: Version bump only for package @feathersjs/express

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

Note: Version bump only for package @feathersjs/express

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

Note: Version bump only for package @feathersjs/express

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)

Features

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

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

Note: Version bump only for package @feathersjs/express

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

Note: Version bump only for package @feathersjs/express

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

Bug Fixes

• Resolve some type problems (#2260) (a3d75fa)
• Update Grant usage and other dependencies (#2264) (7b0f8fa)

Features

• core: Public custom service methods (#2270) (e65abfb)
• Application service types default to any (#1566) (d93ba9a)
• Feathers v5 core refactoring and features (#2255) (2dafb7c)
• core: Remove Uberproto (#2178) (ddf8821)

BREAKING CHANGES

• core: Services no longer extend Uberproto objects and service.mixin() is no longer available.

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

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

Features

• core: use @feathers/hooks and add async type (#1929) (a5c4756)

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

Features

• core: use @feathers/hooks and add async type (#1929) (a5c4756)

4.5.11 (2020-12-05)

Note: Version bump only for package @feathersjs/express

4.5.10 (2020-11-08)

Bug Fixes

• authentication: consistent response return between local and jwt strategy (#2042) (8d25be1)

4.5.9 (2020-10-09)

Note: Version bump only for package @feathersjs/express

4.5.8 (2020-08-12)

Note: Version bump only for package @feathersjs/express

4.5.7 (2020-07-24)

Note: Version bump only for package @feathersjs/express

4.5.6 (2020-07-12)

Note: Version bump only for package @feathersjs/express

4.5.5 (2020-07-11)

Note: Version bump only for package @feathersjs/express

4.5.4 (2020-04-29)

Note: Version bump only for package @feathersjs/express

4.5.3 (2020-04-17)

Note: Version bump only for package @feathersjs/express

4.5.2 (2020-03-04)

Bug Fixes

• Updated typings for express middleware (#1839) (6b8e897)

4.5.1 (2020-01-24)

Note: Version bump only for package @feathersjs/express

4.5.0 (2020-01-18)

Note: Version bump only for package @feathersjs/express

4.4.3 (2019-12-06)

Note: Version bump only for package @feathersjs/express

4.4.1 (2019-11-27)

Note: Version bump only for package @feathersjs/express

4.4.0 (2019-11-27)

Features

• authentication: Add parseStrategies to allow separate strategies for creating JWTs and parsing headers (#1708) (5e65629)

4.3.11 (2019-11-11)

Note: Version bump only for package @feathersjs/express

4.3.10 (2019-10-26)

Note: Version bump only for package @feathersjs/express

4.3.9 (2019-10-26)

Bug Fixes

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

4.3.7 (2019-10-14)

Bug Fixes

• Typings for express request and response properties (#1609) (38cf8c9)

4.3.5 (2019-10-07)

Note: Version bump only for package @feathersjs/express

4.3.4 (2019-10-03)

Note: Version bump only for package @feathersjs/express

4.3.3 (2019-09-21)

Note: Version bump only for package @feathersjs/express

4.3.2 (2019-09-16)

Bug Fixes

• Add info to express error handler logger type (#1557) (3e1d26c)

4.3.1 (2019-09-09)

Note: Version bump only for package @feathersjs/express

4.3.0 (2019-08-27)

Note: Version bump only for package @feathersjs/express

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

Note: Version bump only for package @feathersjs/express

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

Bug Fixes

• Update all dependencies (7d53a00)

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

Bug Fixes

• Add method to reliably get default authentication service (#1470) (e542cb3)

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

Note: Version bump only for package @feathersjs/express

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

Bug Fixes

• Remove unnecessary top level export files in @feathersjs/express (#1442) (73c3fb2)

Features

• @feathersjs/express allow to pass an existing Express application instance (#1446) (853a6b0)

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

Bug Fixes

• @feathersjs/express: allow middleware arrays (#1421) (b605ab8)
• @feathersjs/express: replace reduce with map (#1429) (44542e9)
• Clean up hooks code (#1407) (f25c88b)

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

• Always require strategy parameter in authentication (#1327) (d4a8021)
• Merge httpStrategies and authStrategies option (#1308) (afa4d55)

Features

• Add params.headers to all transports when available (#1303) (ebce79b)
• express use service.methods (#945) (3f0b1c3)

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

Bug Fixes

• Make Mocha a proper devDependency for every repository (#1053) (9974803)
• Update adapter common tests (#1135) (8166dda)
• Update all dependencies to latest (#1206) (e51e0f6)
• chore: Properly configure and run code linter (#1092) (fd3fc34)
• package: update @feathersjs/commons to version 2.0.0 (#31) (c1ef5b1)
• package: update debug to version 3.0.0 (#2) (7e19603)

Features

• @feathersjs/authentication-oauth (#1299) (656bae7)
• Add AuthenticationBaseStrategy and make authentication option handling more explicit (#1284) (2667d92)
• Add TypeScript definitions (#1275) (9dd6713)
• Allow registering a service at the root level (#1115) (c73d322)
• Authentication v3 client (#1240) (65b43bd)
• Authentication v3 Express integration (#1218) (82bcfbe)

BREAKING CHANGES

• Rewrite for authentication v3

1.3.1 (2019-01-02)

Bug Fixes

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

1.3.0 (2018-12-16)

Bug Fixes

• Make Mocha a proper devDependency for every repository (#1053) (9974803)
• chore: Properly configure and run code linter (#1092) (fd3fc34)

Features

• Allow registering a service at the root level (#1115) (c73d322)

1.2.7 (2018-09-21)

Note: Version bump only for package @feathersjs/express

1.2.6 (2018-09-17)

Note: Version bump only for package @feathersjs/express

1.2.5 (2018-09-02)

Note: Version bump only for package @feathersjs/express

1.2.4

• Migrate to Monorepo (feathers#462)

v1.2.3 (2018-06-03)

Full Changelog

Closed issues:

• Question: How to handle JSON:API #26
• [Proposal] Allow multiple express middleware functions to be passed into app.use #24

Merged pull requests:

• Update uberproto to the latest version #28 (bertho-zero)

v1.2.2 (2018-04-16)

Full Changelog

Merged pull requests:

• Allow multiple express middleware functions to be passed into app.use #25 (eXigentCoder)

v1.2.1 (2018-03-29)

Full Changelog

Closed issues:

• Error in error hook results in unhandled rejection #21
• Error handler in wrapper hides breaks and hides real error #13

Merged pull requests:

• Allow to set HTTP status code in a hook #23 (daffl)
• Update axios to the latest version 🚀 #22 (greenkeeper[bot])

v1.2.0 (2018-02-09)

Full Changelog

Closed issues:

• Error in create method results in unhandled rejection #19
• @feathersjs/express call without paramaters could returns an instance of express #18
• Feathers-express blows up the feathers application version property and the example doesn't work #16

Merged pull requests:

• Return an instance of the original Express application when nothing i… #20 (daffl)
• Fix README example #17 (bertho-zero)
• Update mocha to the latest version 🚀 #15 (greenkeeper[bot])
• Update semistandard to the latest version 🚀 #14 (greenkeeper[bot])

v1.1.2 (2017-11-16)

Full Changelog

Merged pull requests:

• Export default and original Express object #12 (daffl)

v1.1.1 (2017-11-06)

Full Changelog

Merged pull requests:

• Also add notFound to export #11 (daffl)

v1.1.0 (2017-11-05)

Full Changelog

Merged pull requests:

• Re-export Express error handler #10 (daffl)

v1.0.0 (2017-11-01)

Full Changelog

v1.0.0-pre.4 (2017-10-25)

Full Changelog

Merged pull requests:

• Update to better returnHook handling #9 (daffl)

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

Full Changelog

Merged pull requests:

• Add REST provider to Express framework bindings #8 (daffl)
• Update repository name and move to npm scope #7 (daffl)
• Update axios to the latest version 🚀 #6 (greenkeeper[bot])

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

Full Changelog

Merged pull requests:

• Also export Express top level functionality #5 (daffl)
• Update mocha to the latest version 🚀 #4 (greenkeeper[bot])
• Update debug to the latest version 🚀 #2 (greenkeeper[bot])

v1.0.0-pre.1 (2017-07-19)

Merged pull requests:

• Update dependencies to enable Greenkeeper 🌴 #1 (greenkeeper[bot])

* _This Change Log was automatically generated by github_changelog_generator_