🍪 nuxt-simple-cookie-consent

[![npm version][npm-version-src]][npm-version-href]
[![npm downloads][npm-downloads-src]][npm-downloads-href]
[![License][license-src]][license-href]
[![Nuxt][nuxt-src]][nuxt-href]

!Banner

A simple, headless, and fully customizable cookie consent module for Nuxt 3.
Built for developers who want full control over styling and behavior, without relying on bloated third-party libraries.

See the example in the playground (uses Nuxt UI)

🚀 Features

- ✅ Headless design – Full control over all UI/UX. The module only provides logic and script handling.
- ✅ Group scripts into multiple categories – Organize by purpose (e.g., analytics, ads, or both).
- ✅ Required categories – Mark categories as required: true to always enable them and prevent opt-out.
- ✅ Reactive useCookieConsent() composable – Easily track consent preferences, expiration, and control flow in your app.
- ✅ Auto-injection and removal of scripts – Scripts are dynamically injected or removed based on real-time user preferences.
- ✅ Support for multi-category scripts – A script can belong to multiple categories (e.g., both ads and analytics).
- ✅ Consent expiration – Automatically expire and re-prompt user consent after a configured number of days.
- ✅ Consent versioning – Force a new prompt if your policy has changed (version mismatch).
- ✅ SSR-safe script control – Scripts are only injected client-side using import.meta.client, avoiding SSR issues.
- ✅ Post-load callbacks – Easily initialize tools like Google Tag Manager or Facebook Pixel after consent is given.
- ✅ Inline & pixel tag support – Supports