@opencookies/solid

Solid adapter for OpenCookies. Built on Solid's signals — fine-grained reactivity with no virtual DOM cost. Wraps @opencookies/core.

Install

bun add @opencookies/core @opencookies/solid

Peer dependencies: solid-js >= 1.8.

Setup

Wrap your app with <OpenCookiesProvider>:

import { OpenCookiesProvider } from "@opencookies/solid";
import type { Category } from "@opencookies/core";
import { render } from "solid-js/web";

const categories: Category[] = [
  { key: "essential", label: "Essential", locked: true },
  { key: "analytics", label: "Analytics" },
  { key: "marketing", label: "Marketing" },
];

render(
  () => (
    <OpenCookiesProvider config={{ categories }}>
      <App />
    </OpenCookiesProvider>
  ),
  document.getElementById("root")!,
);

You can pass a pre-created store with <OpenCookiesProvider store={store}> instead.

API

useConsent()

Returns an object of accessors (call as functions) plus action methods.

import { useConsent } from "@opencookies/solid";
import { Show } from "solid-js";

function Banner() {
  const { route, acceptAll, acceptNecessary, setRoute } = useConsent();
  return (
    <Show when={route() === "cookie"}>
      <div class="banner">
        <button onClick={acceptNecessary}>Necessary only</button>
        <button onClick={acceptAll}>Accept all</button>
        <button onClick={() => setRoute("preferences")}>Customize</button>
      </div>
    </Show>
  );
}

useCategory(key)

Granular per-category access.

import { useCategory } from "@opencookies/solid";

function AnalyticsToggle() {
  const analytics = useCategory("analytics");
  return (
    <label>
      <input type="checkbox" checked={analytics.granted()} onChange={analytics.toggle} />
      Analytics
    </label>
  );
}

<ConsentGate>

Renders children when an expression is satisfied; renders fallback otherwise.

import { ConsentGate } from "@opencookies/solid";

<ConsentGate requires="analytics" fallback={<EnablePrompt />}>
  <Chart />
</ConsentGate>

<ConsentGate requires={{ and: ["analytics", "marketing"] }}>
  <PersonalizedPromo />
</ConsentGate>

SolidStart (SSR)

<OpenCookiesProvider> works in SolidStart — call it from your app.tsx root:

// src/app.tsx
import { OpenCookiesProvider } from "@opencookies/solid";
import { Router } from "@solidjs/router";
import { FileRoutes } from "@solidjs/start/router";
import { categories } from "./cookies";

export default function App() {
  return (
    <OpenCookiesProvider config={{ categories }}>
      <Router>
        <FileRoutes />
      </Router>
    </OpenCookiesProvider>
  );
}

Pass a pre-built store via <OpenCookiesProvider store={store}> if you need SSR-time hydration of decisions from cookies.

Bundling

This package ships source via the solid export condition, so consumers using vite-plugin-solid (Vite, SolidStart, Astro) will compile the components in their own pipeline.

Shared concepts

Categories, GPC handling, jurisdiction resolvers, re-consent triggers, script gating (gateScript), and storage adapters all live in @opencookies/core — the Solid adapter is a thin reactivity wrapper. A working example is in examples/solid.

See also

• @opencookies/core — shared concepts and config reference
• @opencookies/vite — build-time check for ungated cookie / vendor calls
• Other adapters — React, Vue, Svelte

License

Apache-2.0