CanJS model bindings for real-time updates from Feathers
JavaScript HTML
Switch branches/tags
Clone or download
Latest commit a89a646 Jun 22, 2017
Failed to load latest commit information.
test Add cacheService tests to main tests. Aug 24, 2016
shippable.yml Add shippable yml Aug 19, 2016


Greenkeeper badge

Build Status

A set of utils for using CanJS with Feathers client.

can-connect-feathers is the better option for connecting your CanJS application to Feathers.


npm install canjs-feathers --save


Please refer to the Feathers + CanJS page in the official Feathers docs.

Note: The 1.0.0 version of canjs-feathers is only compatible with CanJS 3.0 and DefineMaps (the can-define plugin).

Complete Example

Here's an example of setting up a feathers connection and Account Model for your CanJS application.

import feathers from 'feathers/client';
import socketio from 'feathers-socketio/client';
import hooks from 'feathers-hooks';
import io from '';
import rxjs from 'rxjs';
import rx from 'feathers-reactive';

const host = 'http://localhost:3030';
const socket = io(host, {
  transports: ['websocket'],
  forceReconnect: true
const app = feathers()
	// Use the feathers-reactive plugin for live-updating lists!
  .configure(rx(rxjs, {
    idField: '_id'

// Model creation would usually go in its own file,
// but here it is inline for simplicity.
import DefineMap from 'can-define/map/';
import DefineList from 'can-define/list/';
import Connection from 'canjs-feathers';

// Define a Robot Model.
const Robot = DefineMap.extend('Robot', {
	seal: false
}, {
	'_id': '*',
	model: {type: 'string'}

// Define a Robot.List.
Robot.List = DefineList.extend({
	'*': Robot

// Combine the best of both CanJS and Feathers.
new Connection({
	service: app.service('v1/robots'),
	idProp: '_id',
	Map: Robot

// You can now use `find` directly from the Robot model.
Robot.find({model: 'T1000'}).then(response => {
	// The returned data will be a List (Observable array) of Robot instances.

// Using the service directly will also return Robot instances.
app.service('v1/robots').find({}).then(response => {
	console.log(response); // --> Robot instances!


ES6 use

With StealJS, you can import this module directly in a template that is autorendered:

import plugin from 'canjs-feathers';

CommonJS use

Use require to load canjs-feathers and everything else needed to create a template that uses canjs-feathers:

var plugin = require("canjs-feathers");

AMD use

Configure the can and jquery paths and the canjs-feathers package:

<script src="require.js"></script>
	    paths: {
	        "jquery": "node_modules/jquery/dist/jquery",
	        "can": "node_modules/canjs/dist/amd/can"
	    packages: [{
		    	name: 'canjs-feathers',
		    	location: 'node_modules/canjs-feathers/dist/amd',
		    	main: 'lib/canjs-feathers'
	require(["main-amd"], function(){});

Standalone use

Load the global version of the plugin:

<script src='./node_modules/canjs-feathers/dist/global/canjs-feathers.js'></script>


Making a Build

To make a build of the distributables into dist/ in the cloned repository run

npm install
node build

Running the tests

Tests can run in the browser by opening a webserver and visiting the test.html page. Automated tests that run the tests from the command line in Firefox can be run with

npm test


Copyright (c) 2016, FeathersJS

Licensed under the MIT license.