Your privacy choices

We use necessary cookies, and others only if you allow them. You can change your mind at any time.

Feature · Consent and trust

Compliance

A consent banner and preferences dialog where refusing is exactly as easy as accepting, an append-only record of every decision, and a server gate other code checks before it collects.

PHPReact

What ships today

fancy-compliance is the Laravel side; fancy-compliance-ui is the React side, built from react-fancy, which works with any backend that serves the same JSON.

Refusing is as easy as accepting

Accept all, Reject all and Customise are the same component, size and classes, side by side, and a test fails if one becomes more prominent. Nothing optional is pre-ticked. The banner is a labelled, non-modal region that never takes focus.

Per-category consent

Categories are yours, in config: a key, a label, a description and purposes, every one a translation key. The necessary category always exists and can never be refused. The dialog shows one switch per category.

An append-only consent record

One row per decision, withdrawal or login link: what was granted and refused, under which policy version, from which source. A withdrawal is a new row; the model refuses to edit or delete one. No IP address and no user agent, raw or hashed.

Withdrawal, and re-consent

ConsentPreferencesTrigger opens the dialog at any time, and turning a category off is recorded as a withdrawal. Change the policy version and every earlier decision stops being current: the banner shows again.

A server gate

Consent::allows('analytics') fails closed on an unknown category; the consent:analytics middleware answers 403 until consent; @consent in Blade. ConsentGate and useConsentScript do the same in React, and say honestly when a script that already ran needs a reload.

Styled to your app

Three variants (bar, card, corner) and logical positions that follow RTL. The banner reads react-fancy's theme tokens, and classNames styles each part, with one action key for all three buttons so none can be made easier than another.

An agent can never give consent

Consent is the person's own act; one an agent gave for them is not consent. So the banner, the dialog and the trigger each carry data-agent-off-limits="consent", and agent-integrations 0.58.0 or later refuses every agent action that would reach inside one: a click, a field set, a submit, a focus or a scroll. It refuses before a pendingMode confirm can stage it, and tells the agent only that a consent region exists.

An agent tries the consent controlsLive · agent-integrations

Your privacy choices

We use necessary cookies, and others only if you allow them. You can change your mind at any time.

Ask the agent

    The agent here is agent-integrations' own in-page walker, the one its navigation bridge drives, acting on this page. It may click Subscribe; it is refused at Accept all.

    Keeping the page clear of the bannerLive
    not set --fancy-consent-banner-h on <html>not measured yet padding-bottom of <body>

    Scroll to the foot of the page while the bar shows: the footer stays reachable above it. Decide in the bar, or remove it, and both values go back.

    A fixed banner sits over the page's last content, including the footer's preferences trigger (WCAG 2.4.11, Focus Not Obscured). reserveSpace pads the body by the banner's measured height; layouts that scroll their own wrapper read the variable instead.

    What these packages do not do

    fancy-compliance covers consent only: GDPR data export and erasure are not in it. It does not block a script you inject outside it, and rate limits and geo rules stay yours.

    Looking for bot protection?

    The captcha now lives with the kit's other security capabilities. It still works with consent: fancy-captcha-ui takes anything with allows(category), which useConsent() returns, to keep a third-party captcha behind consent.

    How it fits

    Consent is a PHP package for Laravel and a React package built from react-fancy, which works with any backend that serves the same JSON.

    Install

    1. particle-academy/fancy-compliancePHP
      composer require particle-academy/fancy-compliance
    2. fancy-compliance-uiReact
      npm install @particle-academy/fancy-compliance-ui

    The packages

    Put consent in your app

    Install both halves, define your categories, and render the banner once in your layout. Then read how Fancy Dev Kit handles accessibility, which the banner is held to.