Cookie Consent Tools

Set of tools to help implement user cookie consent. See the demo

It provides:

• a CookieManager module to handle user consent persistence
• an optional mobile-friendly ConsentBox displayed to the user to give him choice.

Installation

npm install cookie-consent-tools

yarn add cookie-consent-tools

Usage

// Import as a Module
import cookieConsentTools from 'cookie-consent-tools';

// Or get it through the window object
var cookieConsentTools = window.cookieConsentTool.default;

// Initialization will look for an existing consent in the cookies
cookieConsentTools.initialize(options);

Options

var options = {
  cookieName: 'cct_choice',
  cookieAttributes: {
    path: '/',
    expires: 365,
    secure: false,
    sameSite: 'strict',
  },
  onConsentLoaded: undefined,
  onConsentUpdated: undefined,
  consentBox: {
    autoDisplay: true,
    container: 'container',
    type: 'message', // or 'choice'
    messages: {
        message: 'This website uses cookies to provide you the best user experience.',
        seeMoreLabel: 'See more...',
        okButton: 'Got it',
        approveButton: 'Allow Cookies',
        declineButton: 'Decline',
    },
    seeMoreLink: {
        href: null,
        target: '_self',
    },
    onOkButtonClick: undefined,
    onApproveButtonClick: undefined,
    onDeclineButtonClick: undefined,
    onShow: undefined,
    onHide: undefined,
  }
});

See the options documentation to have more details about how to use them.

API

Cookie consent tools can be manually managed using methods. See Cookie Manager documentation or Consent Box documentation to have more details.

Executing the Demo App

This library comes with a full demo.

Install local-web-server if you do not have it yet:

npm install -g local-web-server

Then, the demo can be started with:

npm run demo:start

And available at http://127.0.0.1:8000/docs/demo/

Roadmap

This project has to stay light, but some enhancements might be worse the case:

• Theming support for the Consent Box
• Splitting the consent into smaller parts to give the user and the developper more flexibility (ad cookies consent, stats cookies consent, etc.)

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

License

MIT

Project status

This project is a side project I created to handle user cookie consent on multiple websites I own. After looking to the existing projects on GitHub, I did not find one which was light, easy to use and detached from companies who where making GDPR compliance their business.

It is honestly the first open-source project I started on my own, and it was the opportunity for me to discover and implement all tools and processes which guarantee quality and support on this kind of project.

Feel free to contribute and share ideas!