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

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

5.0.29 (2024-07-10)

Note: Version bump only for package @feathersjs/schema

5.0.28 (2024-07-10)

Note: Version bump only for package @feathersjs/schema

5.0.27 (2024-06-18)

Note: Version bump only for package @feathersjs/schema

5.0.26 (2024-06-09)

Bug Fixes

• schema: Allow regular functions in resolvers (#3487) (187868e)

5.0.25 (2024-05-03)

Note: Version bump only for package @feathersjs/schema

5.0.24 (2024-03-13)

Note: Version bump only for package @feathersjs/schema

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

5.0.21 (2024-01-25)

Note: Version bump only for package @feathersjs/schema

5.0.20 (2024-01-24)

Note: Version bump only for package @feathersjs/schema

5.0.19 (2024-01-23)

Note: Version bump only for package @feathersjs/schema

5.0.18 (2024-01-22)

Note: Version bump only for package @feathersjs/schema

5.0.17 (2024-01-22)

Note: Version bump only for package @feathersjs/schema

5.0.16 (2024-01-22)

Note: Version bump only for package @feathersjs/schema

5.0.15 (2024-01-22)

Note: Version bump only for package @feathersjs/schema

5.0.14 (2024-01-05)

Bug Fixes

• schema: Fix setting dispatch on existing nested objects (#3380) (04efd5a)

5.0.13 (2023-12-29)

Note: Version bump only for package @feathersjs/schema

5.0.12 (2023-11-28)

Bug Fixes

• schema: Allow $in and $nin queries to work for arrays (#3352) (677c214)
• schema: Remove undefined $select when using resolveResult hook (#3354) (c43e009)

5.0.11 (2023-10-11)

Bug Fixes

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

5.0.10 (2023-10-03)

Bug Fixes

• schema: Add typescript as peerDependency (#3287) (cb562ee)

5.0.9 (2023-09-27)

Note: Version bump only for package @feathersjs/schema

5.0.8 (2023-07-19)

Note: Version bump only for package @feathersjs/schema

5.0.7 (2023-07-14)

Note: Version bump only for package @feathersjs/schema

5.0.6 (2023-06-15)

Note: Version bump only for package @feathersjs/schema

5.0.5 (2023-04-28)

Bug Fixes

• schema: Exclude json-schema-to-ts@2.8.0 (#3180) (aee8531)

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)
• 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/schema

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

Bug Fixes

• schema: validateQuery - move next function outside of try-catch (#3053) (37fe5c4)

Features

• schema: Add schema helper for handling Object ids (#3058) (1393bed)

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

Bug Fixes

• schema: Do not change the hook context in resolvers (#3048) (bfd8c04)
• schema: Ensure that resolveResult and resolveExternal are run as around hooks (#3032) (71942f4)

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

Bug Fixes

• configuration: Add pool and connection object to SQL database default configuration (#3023) (092c749)
• databases: Ensure that query sanitization is not necessary when using query schemas (#3022) (dbf514e)
• schema: Allow any type in resolver hooks (#3006) (f01281f)
• schema: Ensure all types of nested data are securely dispatched (#3005) (e4a9da5)
• 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)
• schema: Allow to add additional operators to the query syntax (#2941) (f324940)

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

Bug Fixes

• core: context.type for around hooks (#2890) (d606ac6)
• core: Improve service option usage and method option typings (#2902) (164d75c)
• schema: Allow query schemas with no properties, error on unsupported types (#2904) (b66c734)

Features

• adapter: Add patch data type to adapters and refactor AdapterBase usage (#2906) (9ddc2e6)
• cli: Use separate patch schema and types (#2916) (7088af6)
• schema: Split resolver options and property resolvers (#2889) (4822c94)
• schema: Virtual property resolvers (#2900) (7d03b57)

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

Note: Version bump only for package @feathersjs/schema

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

Bug Fixes

• schema: Improve resolver performance (#2822) (5fa900f)
• schema: Use the same options for resolveData hook (#2833) (ed3b050)

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

Features

• cli: Generate full client test suite and improve typed client (#2788) (57119b6)
• cli: Improve generated schema definitions (#2783) (474a9fd)

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

Features

• core: Allow to unregister services at runtime (#2756) (d16601f)
• schema: Make schemas validation library independent and add TypeBox support (#2772) (44172d9)

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

Bug Fixes

• schema: Fix for Ajv global collision bug #2681 (#2702) (0b2def6)

Features

• 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)

Bug Fixes

• Freeze the resolver context (#2685) (247dccb)

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

Note: Version bump only for package @feathersjs/schema

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

Note: Version bump only for package @feathersjs/schema

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

Bug Fixes

• schema: Fix dispatch resovler hook to convert actually resolved data (#2663) (f7e87db)

Features

• cli: Add typed client to a generated app (#2669) (5b801b5)

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

Bug Fixes

• schema: Always resolve dispatch in resolveAll and add getDispatch method (#2645) (145b366)
• schema: remove default from queryProperty schemas (#2646) (940a2b6)

Features

• core: Rename async hooks to around hooks, allow usual registration format (#2652) (2a485a0)

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

Bug Fixes

• schema: Allows resolveData with different resolvers based on method (#2644) (be71fa2)

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

Bug Fixes

• schema: Add Combine helper to allow merging schema types that use (#2637) (06d03e9)
• typescript: Make additional types generic to work with extended types (#2625) (269fdec)

Features

• schema: Add resolveAll hook (#2643) (85527d7)
• schema: Add resolver for safe external data dispatching (#2641) (72b980e)
• schema: Add schema resolver converter functionality (#2640) (26d9e05)

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

Bug Fixes

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

Features

• schema: Add querySyntax helper to create full query schemas (#2621) (2bbb103)

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

Features

• schema: Allow hooks to run resolvers in sequence (#2609) (d85c507)
• typescript: Improve adapter typings (#2605) (3b2ca0a)
• typescript: Improve params and query typeability (#2600) (df28b76)

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

Bug Fixes

• schema: result resolver correctly resolves paginated find result (#2594) (6511e45)

Features

• configuration: Allow app configuration to be validated against a schema (#2590) (a268f86)

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

Bug Fixes

• hooks: Allow all built-in hooks to be used the async and regular way (#2559) (8f9f631)
• queryProperty: allow compound oneOf (#2545) (3077d2d)
• schema: Properly handle resolver errors (#2540) (31fbdff)

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

Bug Fixes

• schema: Do not error for schemas without properties (#2519) (96fdb47)
• schema: Fix resolver data type and use new validation feature in test fixture (#2523) (1093f12)

Features

• schema: Allow to use custom AJV and test with ajv-formats (#2513) (ecfa4df)
• schema: Improve schema typing, validation and extensibility (#2521) (8c1b350)

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

Bug Fixes

• typescript: Overall typing improvements (#2478) (b8eb804)

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

Note: Version bump only for package @feathersjs/schema

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

Note: Version bump only for package @feathersjs/schema

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

Note: Version bump only for package @feathersjs/schema

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

Features

• schema: Allow resolvers to validate a schema (#2465) (7d9590b)

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

Features

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