Composable and Type-safe consent library

@uabcodus/consent is a headless, framework-agnostic consent management library. It handles all the tricky parts — cookie storage, script blocking, consent state, callbacks, revision management — and stays out of your way when it comes to UI.

import { createConsent } from "@uabcodus/consent/core";

const consent = createConsent({
  // configure what you need!
  categories: {
    necessary: { readOnly: true },
    analytics: {},
    marketing: {}
  } as const
});

consent.accept("all"); // fully type-safe
consent.acceptedCategory("analytics"); // true

Why headless?

Framework agnostic

A tiny vanilla JS core that works everywhere. React bindings included — bring your own components, or use ours.

Type-safe

Full TypeScript support with generics that infer your category and service names. Autocomplete all the way.

Composable

Every piece is optional. Use presets, mix in your own config, subscribe to state changes, hook into events.

Production ready

Handles bots, SSR hydration, script blocking, auto-clear, revision re-consent, localStorage fallback, and Google Consent Mode v2.

What you get

• Opt-in and opt-out modes — pick the strategy that fits your legal requirements
• Category & service toggles — granular control with per-service callbacks
• Script management — block <script> tags by data-category until consent is given
• Auto cookie clearing — erase cookies from rejected categories automatically
• Revision management — force re-consent when your policies change
• Google Consent Mode v2 — built-in preset with syncGtagConsent
• React bindings — ConsentProvider + useConsent hook with automatic re-renders
• shadcn/ui components — ready-to-use Banner, Panel, and Toggle components you own
• Cookie or localStorage — your choice

Ready to give it a spin? Jump to the quick start →