Narcoleptic Programmers' Medicine
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

This package has been deprecated

Author message:

Feathers v3 is out and has moved to @feathersjs/feathers. See for more information.


2.2.4 • Public • Published
Feathers logo

Very Important: THIS IS A PREVIOUS VERSION OF FEATHERS. The feathers package and latest version has been moved to @feathersjs/feathers. See for more information.

An open source REST and realtime API layer for modern applications.

Greenkeeper badge

Build Status Code Climate Test Coverage Dependency Status Download Status Slack Status

Feathers is a real-time, micro-service web framework for NodeJS that gives you control over your data via RESTful resources, sockets and flexible plug-ins.

Getting started

You can build your first real-time and REST API in just 4 commands:

$ npm install -g feathers-cli
$ mkdir my-new-app
cd my-new-app/
$ feathers generate app
$ npm start

To learn more about Feathers visit the website at or jump right into the Feathers docs.

See it in action

Here is all the code you need to create a RESTful, real-time message API that uses an in-memory data store:

// app.js
const feathers = require('feathers');
const rest = require('feathers-rest');
const socketio = require('feathers-socketio');
const memory = require('feathers-memory');
const bodyParser = require('body-parser');
const handler = require('feathers-errors/handler');
// A Feathers app is the same as an Express app
const app = feathers();
// Add REST API support
// Configure real-time APIs
// Parse HTTP JSON bodies
// Parse URL-encoded params
app.use(bodyParser.urlencoded({ extended: true }));
// Register our memory "messages" service
app.use('/messages', memory());
// Register a nicer error handler than the default Express one
// Start the server

Then run

npm install feathers feathers-rest feathers-socketio feathers-errors feathers-memory body-parser
node app

and go to http://localhost:3000/messages. That's it! There's a lot more you can do with Feathers including; using a real database, authentication, authorization, clustering and more! Head on over to the Feathers docs to see just how easy it is to build scalable real-time apps.


The Feathers docs are loaded with awesome stuff and tell you every thing you need to know about using and configuring Feathers.


Each plugin has it's own minimal example in the repo. To see a more complex example go to feathersjs/feathers-chat.


We ❤️ the community and take security very seriously. No one wants their app hacked. If you have come across a security concern please report it responsibly. Visit the Security section of the docs to learn more about how you can make sure your app is secure.

Long Term Support Schedule

We are going to be following along with the Node.js long term support cycle. As a result we have dropped official support for node v0.10, v0.12, and iojs versions. Feathers still works on those versions but we're not going to ensure it will going forward.

We will be supporting Node.js v4 until 2018-04-01. We will be supporting Node.js v6 until 2019-04-18.




Feathers contributors


npm i feathers

Downloadsweekly downloads








last publish


  • avatar
  • avatar
Report a vulnerability