# Installing Kinto.js

## NodeJS

If you're using [NodeJS](https://nodejs.org) and [npm](https://www.npmjs.com/) as a frontend package manager, you'll need [NodeJS v6.x.x or higher](https://nodejs.org/download/) installed on your system. Then:

```js
$ npm install kinto --save
```

> #### Notes
>
> *Read more about how to build Kinto.js in the [Contributing section](contributing.md).*

## Static assets

Dev and production ready assets are available in the [`gh-pages` branch of the repository](https://github.com/Kinto/kinto.js/tree/gh-pages). In general, you should download these files and ship them along your own projects, though you can also link them during development:

- Dev version, including source maps: [kinto.js](http://unpkg.com/kinto/dist/kinto.js)
- Production version, minified, no source maps: [kinto.min.js](http://unpkg.com/kinto/dist/kinto.min.js)
- Minimalist version, without polyfills [kinto.noshim.js](http://unpkg.com/kinto/dist/kinto.noshim.js)

> #### Notes
>
> Only stable tags are released as dist files; if you plan on using latest versions from master, you need to [build them manually](contributing.md#generating-dist-files).


### Subresource integrity

To make sure that you are using the right code when loading from a CDN, you can use subresource
integrity with the hash provided below:

```html
    <script src="//unpkg.com/kinto@X.Y.Z/dist/kinto.min.js"
            integrity="sha384-<refer to the table below to retrieve the proper hash>"
            crossorigin="anonymous">
    </script>
```

| Filename                | Hash (for version 12.5.0)                                               |
|-------------------------|-------------------------------------------------------------------------|
| kinto.js                | sha384-xlmrHNG5dknVCc0/5qKnNhw2AFqkrCLVgVhAvioJr5dnv+xnR6RGynbHIi6GH1j5 |
| kinto.min.js            | sha384-L1+zh4/q1QcpuKFnTvXUwQVQbhmrnM5Oqa+BR+Kf5yZRdSY++tsDyemvTCcKN4XD |
| kinto.noshim.js         | sha384-CG5LcTI+KoLBnGM37e33oczwWGLSEB7iU0pZ+AnxQo0/5EONdWPs3IMS+N9Kvzkm |