Cookie Consent

New in 0.8.7. The cookie consent dialog is a built-in feature of the default @docmd/ui package. No plugin install required. Opt-in — nothing is rendered unless you set config.cookie.

A minimal, accessible GDPR-style consent dialog. The user’s choice is persisted in localStorage with a configurable TTL. A docmd:cookie-consent CustomEvent fires on window after a choice is made so plugins and templates can react (e.g. enable analytics, load third-party scripts).

Enable in 30 seconds

{
  "cookie": {
    "enabled": true,
    "message": "We use cookies to ensure you get the best experience.",
    "policyUrl": "/privacy",
    "position": "bottom-right"
  }
}

Build, and the dialog appears on first visit. Subsequent visits respect the stored choice.

Configuration reference

Position values

Localisation

All user-facing strings support the existing t(key) translation system. Override the keys in your translations/<locale>.json files:

{
  "cookieMessage": "Cette page utilise des cookies pour vous offrir la meilleure expérience.",
  "cookieAccept": "Accepter",
  "cookieDecline": "Refuser",
  "cookiePolicy": "Politique de confidentialité",
  "cookieConsent": "Consentement aux cookies"
}

Reacting to a choice

A CustomEvent named docmd:cookie-consent is dispatched on window after the user accepts, declines, or dismisses:

window.addEventListener('docmd:cookie-consent', (e) => {
  if (e.detail.value === 'accept') {
    // Load analytics, marketing scripts, etc.
  }
});

The detail.value is one of "accept", "decline", or "dismissed". If you need to read the choice synchronously (e.g. before any other script runs), localStorage.getItem('docmd-cookie-consent') returns the same payload.

Re-styling

The dialog is built from BEM-style classes on the .docmd-cookie-banner root. Re-skin it via customCss (always wins at priority 15):

.docmd-cookie-banner {
  --accent-color: #ff5a5f;
  border-radius: 16px;
}
.docmd-cookie-banner__btn--accept {
  background-color: var(--accent-color);
  border-color: var(--accent-color);
}

Disabling

To remove the dialog entirely, simply remove the cookie key from your config. There is no plugin to disable.