Skip to content

chiiya/haven

Repository files navigation

Haven

GDPR-ready cookie consent manager with zero dependencies.


Overview

Haven is a simple-to-use cookie consent manager enabling GDPR and ePrivacy compliance with just a few lines of code. Haven comes with the following features included out of the box:

Feature
📣 Cookie notification for opt-in and opt-out strategies.
🔧 Cookie preferences enabling users to revoke or change their consent at any time.
📥 Automatic injection of services (google-analytics, google-tag-manager, facebook-pixel or any custom solution) at runtime, after the user has given their consent.
🗑️ Removal of all tracking cookies after a user has revoked their consent.
📙 Translations for multiple languages with easy customization.
🤖 Written in TS, and as such compatible with ES5, ES6+ and TS projects out of the box.

Quickstart

Installation

npm i @chiiya/haven -S

Usage

To use Haven in your project, either load the library via a script tag in your HTML, or import it as a module in your Javascript.

Script Tag
<script src="https://unpkg.com/@chiiya/haven"></script>
<script>
Haven.create({
    services: [
        {
            name: 'google-analytics',
            options: {
                    id: 'UA-XXXXXXXX-1',
            },
            purposes: ['analytics'],
            inject: true,
        }
    ]
});
</script>
ES5 Import
var { Haven } = require('haven');

Haven.create({
    services: [
        {
            name: 'google-analytics',
            options: {
                    id: 'UA-XXXXXXXX-1',
            },
            purposes: ['analytics'],
            inject: true,
        }
    ]
});
ES6+ Import
import Haven from '@chiiya/haven';

Haven.create({
    services: [
        {
            name: 'google-analytics',
            options: {
                    id: 'UA-XXXXXXXX-1',
            },
            purposes: ['analytics'],
            inject: true,
        }
    ]
});

With that, users will get a cookie notification asking for their consent. Google Analytics will only be loaded once this consent has been given. Users may revoke their consent at any time by using the settings injected into your privacy policy page. Upon consent revoke, all tracking cookies set by Google Analytics will be removed.

For further information and configuration details, check out the documentation.

Polyfills

Haven is compiled using Babel targeting browsers with more than 1% of global usage and expecting that all features listed below are available or polyfilled in browser:

Object.keys()
Object.values()
Object.assign()
String.startsWith()
Array.flat()
Array.forEach()
Set

If you need to support a browser that does not have one of the features listed above, I suggest including a polyfill from polyfill.io:

<script crossorigin="anonymous" src="https://polyfill.io/v3/polyfill.min.js?features=Object.keys%2CObject.values%2CObject.assign%2CSet%2CString.prototype.startsWith%2CArray.prototype.flat"></script>