Ballmac UI home

Cookie ConsentPRO

A privacy banner with equal-weight Accept all and Reject non-essential, plus a preferences view with a switch per category and locked required ones.

Installation

  1. Get a Pro licence key.

    The source is part of Ballmac UI Pro.

    Log in with your licence key to read and copy it here, or install it through the shadcn CLI or the MCP server. You own the code once it is in your project.

    $49 once regular price $99for this and every other Pro item. Tax included.Money back if it does not work.

  2. Once per project: add the Pro registry and your licence key.

    components.json
    {
      "registries": {
        "@ballmac": "https://ui.ballmac.com/r/{name}.json",
        "@ballmac-pro": {
          "url": "https://ui.ballmac.com/r/pro/{name}.json",
          "headers": { "Authorization": "Bearer ${BALLMAC_LICENSE_KEY}" }
        }
      }
    }
    .env.local
    BALLMAC_LICENSE_KEY=your-licence-key
  3. Add it.

    $ pnpm dlx shadcn@latest add @ballmac-pro/cookie-consent

Usage

import { CookieConsent } from "@/components/ballmac/cookie-consent"

The full example is in the Code tab above.

Examples

No choice yet

API reference

PropTypeDefault
categories*

Cookie categories. Put required ones first.

ConsentCategory[]—
onConsent

Called with the choice when the visitor decides.

(choice: ConsentChoice) => void—
storageKey

localStorage key. When set, the banner stays hidden once a choice is saved there and the choice is saved for you. Leave undefined to manage visibility yourself with `open`.

string—
open

Controlled visibility. Overrides the stored state.

boolean—
title

Banner heading.

string—
description

Short explanation.

React.ReactNode—
policyHref

Link to your cookie or privacy policy.

string—
placement

Where the banner sits.

"bottom-left" | "bottom-right" | "bottom-center""bottom-left"

Also accepts the standard attributes of its root element.

Accessibility

KeyAction
TabButtons and switches are all reachable; the banner never traps focus
FocusOpening preferences moves focus to the new heading
Screen readersA labelled non-modal dialog; switches announce their state

Quality scorecard

7/7

Every applicable check passes

Measured in Chromium 153.0.8010.12 on October 19, 2026, on version 1.0.0, across 2 examples.

How we measure
  • Passed: Accessibility scan

    No serious or critical issues in light and dark, on a phone and a desktop (axe-core 4.13.0, WCAG 2.1 AA and best-practice rules).

  • Passed: Small screens

    No sideways scrolling at 360, 390 or 1280 px wide.

  • Passed: Reduced motion

    No endless animation to begin with.

  • Passed: Right to left

    Mirrors correctly in Arabic, Hebrew, Persian and Urdu layouts (5% of elements off the mirror, limit 15%).

  • Passed: Clean console

    No console errors or React hydration errors while loading.

  • Passed: Keyboard

    7 tab stops, each showing a visible change when it takes focus. 3 documented keys.

  • Not applicable: Loading, empty and error

    Does not show data or take submissions.

  • Passed: Automated tests

    Covered by cookie-consent.test.tsx.

  • For information: Footprint

    3.3 KB of source (gzip) in 1 file. Installs motion, lucide-react.

Automated checks find a subset of problems and do not replace testing with a screen reader and a keyboard in your own app. What they miss.

Use with AI

categories[] with {id,label,description,required}. onConsent receives a map of category to boolean. storageKey saves and remembers the choice in localStorage. With the shadcn MCP server set up (guide), ask your agent:

Add the Ballmac UI Cookie Consent (@ballmac-pro/cookie-consent) to this project with the shadcn MCP, then use it where it fits.

Use it for

  • Sites that set non-essential cookies
  • Consent prompts for analytics and marketing

Not for

  • Legal advice: check your own requirements
  • Unrelated notices; use banner

Registry JSON (needs your licence key): https://ui.ballmac.com/r/pro/cookie-consent.json

Credits

Covered by the Ballmac UI Pro license.