node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »


Nexus Uplink Server (Simple)

Nexus Uplink is an dead-simple, lightweight protocol on top of which Flux over the Wire can be implemented.

On the client side, a Nexus Uplink Client can react to stores updates, and dispatch actions. On the server side, a Nexus Uplink Server can react to actions dispatchs, and update stores.


  • actions are transported via POST requests (url pathname is the action identifier, JSON-encoded body is the payload)
  • updates are transported via Websocket (or Engine.IO fallback) (as diff objects)

This package is a simple (but efficient) implementation of the Nexus Uplink server-side protocol. Also see the isomorphic client implementation of the Nexus Uplink client-side protocol.


On the server:

var server = new UplinkSimpleServer({
  pid: _.guid('pid'),
  // stores, rooms and actions are url patterns whitelists 
  stores: ['/ping'],
  rooms: [],
  actions: ['/ping'],
  // pass an express or express-like app 
  app: express().use(cors())
var pingCounter = 0;
// setup action handlers 
server.actions.on('/ping', function(payload) {
  // guid is a cryptosecure unique user id, automatically maintained 
  var guid = payload.guid;
  var remoteDate = payload.localDate;
  var localDate =;
  console.log('client ' + guid + ' pinged.');
  console.log('latency is ' + (localDate - remoteDate) + '.');
  server.update({ path: '/ping', value: { counter: pingCounter }});

On the client:

var client = new Uplink({ url: 'http://localhost' });
// subscribe to remote updates 
client.subscribeTo('/ping', function(ping) {
  console.log('ping updated', ping.counter);
// fire-and-forget dispatch actions 
setInterval(function() {
  client.dispatch('/ping', { localDate: });
}, 1000);


npm install nexus-uplink-simple-server --save