Client webapp for the Mozilla readinglist API.

Usage no npm install needed!

<script type="module">
  import readinglistClient from '';


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