Skip to content
This repository has been archived by the owner on Nov 14, 2018. It is now read-only.


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Readinglist client

Build Status Dependency Status

This is work in progress at a temporary location.


Requires nodejs v0.10.29+ and npm v2.1.0+. To install the required dependencies:

$ npm install

This Web client also requires a running instance of the Readinglist server.


You can configure the client using the following environment variables:

  • CLIENT_DEVICE_IDENTIFIER: The client identifier name; used when updating article read status (default: readinglist-client).
  • MAX_ITEMS_PER_PAGE: The maximum number of articles per result page; default: 10.
  • NODE_ENV: The nodejs environment name; default: production.
  • READINGLIST_SERVER_BASEURL: the Readinglist server base URL; default:
  • READABLE_PROXY_URL: the readable-proxy server base endpoint; default:

Environment variables will be used during the build step to replace matching placeholders in resulting js assets. Eg. that means if you want to override the default API base url running the local development server, you can run:

$ READINGLIST_SERVER_BASEURL=http://my.alt.domain.tld npm start

Building & deploying

$ READINGLIST_SERVER_BASEURL="http://production.server.tld" \
  npm run build

Result is then available in the build/ subfolder. This is what should be deployed to production.

Local dev server

$ npm start


  • This local development server will watch for local asset changes and live-reload the page automatically;
  • It will set NODE_ENVto development;
  • The address used is http://localhost:4000.


$ npm run lint


This will run the unit test suite against a Karma browser matrix and exits.

$ npm test


This will launch a live Karma server watching and running tests on each source change.

$ npm run tdd