Horizon Client Library

The Horizon client library. Built to interact with the Horizon Server API. Provides all the tooling to build a fully-functional and reactive front-end web application.

Building

Running npm install for the first time will build the browser bundle and lib files.

1. npm install
2. npm run dev (or npm run build or npm run compile, see below)

Build Options

Command | Description --------------------|---------------------------- npm run build | Build dist/horizon.js minified production browser bundle npm run builddebug | Build with webpack and output debug logging npm run compile | Compile src to lib for CommonJS module loaders (such as webpack, browserify) npm run coverage | Run code coverage tool - istanbul npm run dev | Watch directory for changes, build dist/horizon.js unminified browser bundle npm run devtest | Serve dist directory to build app and continuously run tests npm test | Run tests in node npm run lint -s | Lint src npm run test | Run tests

Running tests

• npm test or open dist/test.html in your browser after getting setup and while you also have Horizon server with the --dev flag running on localhost.
• You can spin up a dev server by cloning the horizon repo and running node serve.js in test directory in repo root. Then tests can be accessed from http://localhost:8181/test.html. Source maps work properly when served via http, not from file system. You can test the production version via NODE_ENV=production node serve.js. You may want to use test/setupDev.sh to set the needed local npm links for development.

Docs

Getting Started

horizon.io/docs/getting-started.

APIs

• Horizon API - horizon.io/api/horizon/
• Collection API - horizon.io/api/collection/

Users and Groups

horizon.io/docs/users/

Setting Permissions

horizon.io/docs/permissions/

Clearing tokens

Sometimes you may wish to delete all authentication tokens from localStorage. You can do that with:

// Note the 'H'
Horizon.clearAuthTokens()