@c15t/react 2.0.0-rc.9 → 2.0.2

package/docs/concepts/client-modes.md

@@ -15,7 +15,7 @@ c15t supports three client modes that determine how consent data is stored and s
 
 ## Hosted Mode (Recommended)
 
-The default mode. Connects to a c15t backend for full consent lifecycle management. We recommend using [consent.io](https://consent.io) for a fully managed experience, but you can [self-host](/docs/self-host) as well.
+The default mode. Connects to a c15t backend for full consent lifecycle management. We recommend using [inth.com](https://inth.com) for a fully managed experience, but you can [self-host](/docs/self-host) as well.
 
 > ℹ️ **Info:**
 > mode: 'hosted' is the preferred value. The legacy alias mode: 'c15t' is still supported for backward compatibility.

package/docs/concepts/policy-packs.md

@@ -8,7 +8,7 @@ A policy pack is an ordered array of policies. Each policy targets a region or c
 
 There are three ways to configure policy packs:
 
-1. **consent.io (recommended)** — use [consent.io](https://consent.io) as your hosted backend. Configure packs visually in the dashboard or via API — no code changes required. Works with any frontend, including static sites.
+1. **inth.com (recommended)** — use [inth.com](https://inth.com) as your hosted backend. Configure packs visually in the dashboard or via API — no code changes required. Works with any frontend, including static sites.
 2. **Self-hosted backend** — define packs in code via `policyPacks` and resolve them from real request geo data. Full control over policy logic and storage.
 3. **Offline fallback** — pass the same policy shapes to the frontend via `offlinePolicy.policyPacks`. Use this mainly for local development, demos, deterministic testing, or resilience when the backend is temporarily unreachable. If you omit `offlinePolicy.policyPacks`, c15t falls back to a synthetic worldwide opt-in banner instead of no-banner mode.
 

package/docs/hooks/use-consent-manager/overview.md

@@ -87,7 +87,7 @@ Information about when and how consent was given
 |:--|:--|:--|:--|:--:|
 |time|number|The epoch timestamp of when the consent was recorded|-|✅ Required|
 |subjectId|string \|undefined|The client-generated subject ID in sub\_xxx format|-|Optional|
-|id|string \|undefined|Configuration for the legal links @remarks Legal links can display across different parts of the consent manager such as the consent banner & dialog.|-|Optional|
+|id|string \|undefined|Effective GPC signal used for the request.|-|Optional|
 |externalId|string \|undefined|The external user ID linked to this subject|-|Optional|
 |materialPolicyFingerprint|string \|undefined|Material fingerprint of the active policy when this consent was accepted.|-|Optional|
 |identityProvider|string \|undefined|The identity provider that provided the external ID|-|Optional|
@@ -189,6 +189,7 @@ IAB TCF 2.3 state and actions (null when not configured or not in IAB mode).
 |setOverrides|Object \|undefined \|null|Sets the overrides for the consent manager. Automatically attempts to fetch the consent manager again with the new overrides.|-|✅ Required|
 |setLanguage|Object \|undefined \|null|Set the language override for the consent manager. This will override the language detected from the browser and re-fetch the consent banner information.|-|✅ Required|
 |identifyUser|Object|Identifies the user by setting the external ID.|-|✅ Required|
+|unstable\_acceptPolicyConsent|Object \|undefined|Writes a policy-based consent such as terms and conditions.|-|✅ Required|
 |setSelectedConsent|(name: AllConsentNames, value: boolean) => void|Updates the selected consent state for a specific consent type.|-|✅ Required|
 |saveConsents|Object \|undefined|Saves the user's consent preferences.|-|✅ Required|
 |setConsent|(name: AllConsentNames, value: boolean) => void|Updates the consent state for a specific consent type & automatically save the consent.|-|✅ Required|
@@ -246,6 +247,21 @@ Identifies the user by setting the external ID.
 |id|string|Usually your own internal ID for the user from your auth provider|-|✅ Required|
 |identityProvider|string \|undefined|The identity provider of the user. Usually the name of the identity provider e.g. 'clerk', 'auth0', 'custom', etc.|-|Optional|
 
+#### `unstable_acceptPolicyConsent`
+
+Writes a policy-based consent such as terms and conditions.
+
+|Property|Type|Description|Default|Required|
+|:--|:--|:--|:--|:--:|
+|type|Object|-|-|✅ Required|
+|domain|string \|undefined|-|-|Optional|
+|givenAt|number \|undefined|-|-|Optional|
+|metadata|Record\<string, unknown> \|undefined|-|-|Optional|
+|preferences|Record\<string, boolean> \|undefined|-|-|Optional|
+|uiSource|string \|undefined|-|-|Optional|
+|externalId|string \|undefined|-|-|Optional|
+|identityProvider|string \|undefined|-|-|Optional|
+
 #### `subscribeToConsentChanges`
 
 Subscribes to change-only consent saves.
@@ -344,7 +360,7 @@ function LoginForm() {
 ```
 
 > ℹ️ **Info:**
-> identifyUser sends the user data to the c15t backend. It only works in 'c15t' mode — in 'offline' mode the call is a no-op.
+> identifyUser sends the user data to the c15t backend. It works in hosted mode, including the legacy alias mode: 'c15t'. In mode: 'offline', the call is a no-op.
 
 ## Key Types
 

package/docs/iab/consent-banner.md

@@ -2,8 +2,8 @@
 title: IABConsentBanner
 description: An IAB TCF 2.3 compliant consent banner that displays partner count, purpose summaries, and legitimate interest notices.
 ---
-> ❌ **Error:**
-> c15t is not yet IAB certified. The IAB TCF components are under active development and should not be used in production. APIs and behavior may change before certification is achieved.
+> ℹ️ **Info:**
+> c15t's IAB TCF support can be used in production. Use Inth for a hosted, IAB TCF-certified CMP setup with a managed CMP ID, or register your own CMP with IAB Europe and configure your own CMP ID.
 
 `IABConsentBanner` is a pre-built consent banner that follows the [IAB Transparency & Consent Framework (TCF) 2.3](https://iabeurope.eu/tcf-2-0/) specification. It renders when the consent model is set to `'iab'` and includes required disclosures like partner count, purpose summaries, and legitimate interest notices.
 
@@ -19,6 +19,7 @@ Use this component instead of `ConsentBanner` when you need IAB TCF compliance f
 
 ```tsx
 import { type ReactNode } from 'react';
+import { iab } from '@c15t/iab';
 import { ConsentManagerProvider } from '@c15t/react';
 import { IABConsentBanner, IABConsentDialog } from '@c15t/react/iab';
 
@@ -28,11 +29,12 @@ export default function ConsentManager({ children }: { children: ReactNode }) {
       options={{
         mode: 'hosted',
         backendURL: 'https://your-instance.c15t.dev',
-        iab: {
-          enabled: true,
-          cmpId: 123,
+        iab: iab({
           vendors: [1, 2, 10, 25],
-        },
+          // cmpId is automatically provided by the backend when using Inth.
+          // Only set this if you have your own CMP registration.
+          // cmpId: 123,
+        }),
       }}
     >
       <IABConsentBanner />

package/docs/iab/consent-dialog.md

@@ -2,8 +2,8 @@
 title: IABConsentDialog
 description: An IAB TCF 2.3 compliant preference center with tabbed purpose and vendor management.
 ---
-> ❌ **Error:**
-> c15t is not yet IAB certified. The IAB TCF components are under active development and should not be used in production. APIs and behavior may change before certification is achieved.
+> ℹ️ **Info:**
+> c15t's IAB TCF support can be used in production. Use Inth for a hosted, IAB TCF-certified CMP setup with a managed CMP ID, or register your own CMP with IAB Europe and configure your own CMP ID.
 
 `IABConsentDialog` is an IAB TCF 2.3 compliant consent dialog that provides a tabbed interface for managing purpose consent and vendor preferences. It includes purpose grouping via stacks, individual purpose/vendor toggles, special purpose and feature disclosures, and legitimate interest handling.
 
@@ -13,6 +13,7 @@ Pair it with `IABConsentBanner` inside the provider:
 
 ```tsx
 import { type ReactNode } from 'react';
+import { iab } from '@c15t/iab';
 import { ConsentManagerProvider } from '@c15t/react';
 import { IABConsentBanner, IABConsentDialog } from '@c15t/react/iab';
 
@@ -22,11 +23,12 @@ export default function ConsentManager({ children }: { children: ReactNode }) {
       options={{
         mode: 'hosted',
         backendURL: 'https://your-instance.c15t.dev',
-        iab: {
-          enabled: true,
-          cmpId: 123,
+        iab: iab({
           vendors: [1, 2, 10, 25],
-        },
+          // cmpId is automatically provided by the backend when using Inth.
+          // Only set this if you have your own CMP registration.
+          // cmpId: 123,
+        }),
       }}
     >
       <IABConsentBanner />

package/docs/iab/overview.md

@@ -15,12 +15,12 @@ When your site participates in the IAB ecosystem (ad exchanges, SSPs, DSPs, DMPs
 
 ## CMP Registration
 
-[consent.io](https://consent.io) is pending validation as an IAB Europe-registered CMP for c15t. Once approved, when you use consent.io as your backend, the correct CMP ID will be automatically provided to your client via the `/init` endpoint — no client-side configuration needed.
+[Inth](https://inth.com), c15t's hosted platform, is IAB TCF certified. When you use Inth as your backend with c15t's prebuilt IAB UI, the correct CMP ID is automatically provided to your client via the `/init` endpoint — no client-side configuration needed.
 
-If you self-host the c15t backend and have your own CMP registration with IAB Europe, you can configure your CMP ID on the backend via `advanced.iab.cmpId` or on the client via the `iab.cmpId` option. A valid (non-zero) CMP ID is required for IAB TCF compliance.
+If you self-host the c15t backend or want to operate as your own CMP, register your own CMP with IAB Europe and configure your CMP ID on the backend via `advanced.iab.cmpId` or on the client via the `iab.cmpId` option. Registering your own CMP may also involve IAB Europe fees, so check IAB Europe's current CMP registration terms and pricing before choosing this route. A valid (non-zero) CMP ID is required for IAB TCF compliance.
 
 > ℹ️ **Info:**
-> If you heavily customize or build your own IAB banner or dialog (rather than using the default IABConsentBanner and IABConsentDialog components), you cannot use consent.io's CMP ID. You must register your own CMP with IAB Europe and use your own CMP ID.
+> If you heavily customize or build your own IAB banner or dialog instead of using the default IABConsentBanner and IABConsentDialog components, you cannot use Inth's CMP ID. You must register your own CMP with IAB Europe and use your own CMP ID.
 
 ## How c15t Implements TCF
 
@@ -45,6 +45,7 @@ If you use the prebuilt styled IAB UI, import the IAB stylesheet alongside the b
 
 ```tsx
 import { type ReactNode } from 'react';
+import { iab } from '@c15t/iab';
 import { ConsentManagerProvider } from '@c15t/react';
 import { IABConsentBanner, IABConsentDialog } from '@c15t/react/iab';
 
@@ -54,13 +55,12 @@ export default function ConsentManager({ children }: { children: ReactNode }) {
       options={{
         mode: 'hosted',
         backendURL: 'https://your-instance.c15t.dev',
-        iab: {
-          enabled: true,
+        iab: iab({
           vendors: [1, 2, 10, 25],  // IAB vendor IDs you work with
-          // cmpId is automatically provided by the backend (consent.io).
+          // cmpId is automatically provided by the backend (inth.com).
           // Only set this if you have your own CMP registration with IAB Europe.
           // cmpId: 123,
-        },
+        }),
       }}
     >
       <IABConsentBanner />
@@ -73,14 +73,13 @@ export default function ConsentManager({ children }: { children: ReactNode }) {
 
 ## IAB Configuration Options
 
-The `iab` option on the provider accepts:
+Configure IAB mode with `iab({ ... })` from `@c15t/iab`. The factory enables the addon and injects the runtime module automatically. The user-facing options are:
 
 |Option|Type|Description|
 |--|--|--|
-|`enabled`|`boolean`|Enable IAB TCF mode|
-|`cmpId`|`number`|CMP ID registered with IAB Europe. Automatically provided by the backend when using consent.io. Only set this if you have your own CMP registration.|
+|`cmpId`|`number`|CMP ID registered with IAB Europe. Automatically provided by the backend when using Inth with the prebuilt IAB UI. Only set this if you have your own CMP registration.|
 |`vendors`|`number[]`|IAB vendor IDs that your site works with|
-|`nonIABVendors`|`NonIABVendor[]`|Custom vendors not in the IAB registry|
+|`customVendors`|`NonIABVendor[]`|Custom vendors not in the IAB registry|
 
 ## Key Concepts
 
@@ -122,4 +121,6 @@ Each vendor in the GVL declares which purposes it uses, whether via consent or l
 |--|--|
 |[IABConsentBanner](/docs/frameworks/react/iab/consent-banner)|TCF-compliant banner with partner disclosure|
 |[IABConsentDialog](/docs/frameworks/react/iab/consent-dialog)|Tabbed preference center for purposes and vendors|
-|[useGVLData](/docs/frameworks/react/iab/use-gvl-data)|Hook for building custom IAB UI|
+
+> ℹ️ **Info:**
+> For lower-level custom IAB flows, use useHeadlessIABConsentUI() from @c15t/react/iab. useGVLData() is currently internal and is not part of the public package surface.

package/docs/iab/use-gvl-data.md

@@ -1,208 +1,20 @@
 ---
-title: useGVLData
-description: Hook to access processed Global Vendor List (GVL) data for building custom IAB TCF UI components.
+title: useGVLData (Internal)
+description: Status note for the internal GVL hook used by the built-in IAB dialog.
 ---
-> ❌ **Error:**
-> c15t is not yet IAB certified. The IAB TCF components are under active development and should not be used in production. APIs and behavior may change before certification is achieved.
-
-`useGVLData()` processes the raw IAB Global Vendor List (GVL) into a UI-friendly format. It handles purpose grouping into stacks, vendor mapping, special purpose/feature extraction, and loading state.
-
-Use this hook when building a custom IAB TCF UI instead of the pre-built `IABConsentDialog`.
-
-```tsx
-import { useGVLData } from '@c15t/react/hooks';
-
-function CustomIABPreferences() {
-  const { purposes, stacks, standalonePurposes, totalVendors, isLoading } = useGVLData();
-
-  if (isLoading) return <p>Loading vendor data...</p>;
-
-  return (
-    <div>
-      <p>{totalVendors} partners</p>
-      {standalonePurposes.map((purpose) => (
-        <div key={purpose.id}>
-          <h3>{purpose.name}</h3>
-          <p>{purpose.description}</p>
-          <p>{purpose.vendors.length} vendors</p>
-        </div>
-      ))}
-    </div>
-  );
-}
-```
-
 > ℹ️ **Info:**
-> Must be used within a ConsentManagerProvider with IAB mode enabled. Returns empty data if IAB is not configured.
-
-## Return Value
-
-The hook returns a `GVLData` object:
-
-### GVLData
-
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|purposes|ProcessedPurpose|-|-|✅ Required|
-|specialPurposes|ProcessedPurpose|-|-|✅ Required|
-|specialFeatures|ProcessedSpecialFeature|-|-|✅ Required|
-|features|ProcessedFeature|-|-|✅ Required|
-|stacks|ProcessedStack|-|-|✅ Required|
-|standalonePurposes|ProcessedPurpose|-|-|✅ Required|
-|totalVendors|number|-|-|✅ Required|
-|isLoading|boolean|-|-|✅ Required|
-
-#### `purposes` ProcessedPurpose
-
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|number|-|-|✅ Required|
-|name|string|-|-|✅ Required|
-|description|string|-|-|✅ Required|
-|descriptionLegal|string \|undefined|-|-|Optional|
-|illustrations|string\[]|-|-|✅ Required|
-|vendors|ProcessedVendor|-|-|✅ Required|
-|isSpecialPurpose|boolean \|undefined|-|-|Optional|
-
-#### `specialPurposes` ProcessedPurpose
-
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|number|-|-|✅ Required|
-|name|string|-|-|✅ Required|
-|description|string|-|-|✅ Required|
-|descriptionLegal|string \|undefined|-|-|Optional|
-|illustrations|string\[]|-|-|✅ Required|
-|vendors|ProcessedVendor|-|-|✅ Required|
-|isSpecialPurpose|boolean \|undefined|-|-|Optional|
-
-#### `specialFeatures` ProcessedSpecialFeature
+> c15t's IAB TCF support can be used in production through Inth or with your own registered CMP ID. useGVLData() is different: it remains an internal hook and is not part of the supported public API.
 
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|number|-|-|✅ Required|
-|name|string|-|-|✅ Required|
-|description|string|-|-|✅ Required|
-|descriptionLegal|string \|undefined|-|-|Optional|
-|illustrations|string\[]|-|-|✅ Required|
-|vendors|ProcessedVendor|-|-|✅ Required|
+`useGVLData()` currently powers the built-in `IABConsentDialog`, but it is **not part of the public package surface**.
 
-#### `features` ProcessedFeature
+Older docs showed it as a public hook. That is no longer accurate.
 
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|number|-|-|✅ Required|
-|name|string|-|-|✅ Required|
-|description|string|-|-|✅ Required|
-|descriptionLegal|string \|undefined|-|-|Optional|
-|illustrations|string\[]|-|-|✅ Required|
-|vendors|ProcessedVendor|-|-|✅ Required|
+If you need supported customization points today:
 
-#### `stacks` ProcessedStack
+* Use `IABConsentBanner` and `IABConsentDialog` from `@c15t/react/iab` for the supported prebuilt UI
+* Use `useHeadlessIABConsentUI()` from `@c15t/react/iab` when you need lower-level control over banner/dialog state and actions
 
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|number|-|-|✅ Required|
-|name|string|-|-|✅ Required|
-|description|string|-|-|✅ Required|
-|purposes|ProcessedPurpose|-|-|✅ Required|
-
-#### `standalonePurposes` ProcessedPurpose
-
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|number|-|-|✅ Required|
-|name|string|-|-|✅ Required|
-|description|string|-|-|✅ Required|
-|descriptionLegal|string \|undefined|-|-|Optional|
-|illustrations|string\[]|-|-|✅ Required|
-|vendors|ProcessedVendor|-|-|✅ Required|
-|isSpecialPurpose|boolean \|undefined|-|-|Optional|
-
-## Types
-
-### ProcessedPurpose
-
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|number|-|-|✅ Required|
-|name|string|-|-|✅ Required|
-|description|string|-|-|✅ Required|
-|descriptionLegal|string \|undefined|-|-|Optional|
-|illustrations|string\[]|-|-|✅ Required|
-|vendors|ProcessedVendor|-|-|✅ Required|
-|isSpecialPurpose|boolean \|undefined|-|-|Optional|
-
-#### `vendors` ProcessedVendor
-
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|VendorId|-|-|✅ Required|
-|name|string|-|-|✅ Required|
-|policyUrl|string|-|-|✅ Required|
-|usesNonCookieAccess|boolean|-|-|✅ Required|
-|deviceStorageDisclosureUrl|string \|null|-|-|✅ Required|
-|usesCookies|boolean|-|-|✅ Required|
-|cookieMaxAgeSeconds|number \|null|-|-|✅ Required|
-|cookieRefresh|boolean \|undefined|-|-|Optional|
-|specialPurposes|number\[]|-|-|✅ Required|
-|specialFeatures|number\[]|-|-|✅ Required|
-|features|number\[]|-|-|✅ Required|
-|purposes|number\[]|-|-|✅ Required|
-|legIntPurposes|number\[]|-|-|✅ Required|
-|legitimateInterestUrl|string \|null \|undefined|-|-|Optional|
-|isCustom|boolean \|undefined|-|-|Optional|
-|usesLegitimateInterest|boolean \|undefined|-|-|Optional|
-|dataRetention|Object \|undefined|-|-|Optional|
-|dataDeclaration|number\[] \|undefined|-|-|Optional|
-
-### ProcessedVendor
-
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|VendorId|-|-|✅ Required|
-|name|string|-|-|✅ Required|
-|policyUrl|string|-|-|✅ Required|
-|usesNonCookieAccess|boolean|-|-|✅ Required|
-|deviceStorageDisclosureUrl|string \|null|-|-|✅ Required|
-|usesCookies|boolean|-|-|✅ Required|
-|cookieMaxAgeSeconds|number \|null|-|-|✅ Required|
-|cookieRefresh|boolean \|undefined|-|-|Optional|
-|specialPurposes|number\[]|-|-|✅ Required|
-|specialFeatures|number\[]|-|-|✅ Required|
-|features|number\[]|-|-|✅ Required|
-|purposes|number\[]|-|-|✅ Required|
-|legIntPurposes|number\[]|-|-|✅ Required|
-|legitimateInterestUrl|string \|null \|undefined|-|-|Optional|
-|isCustom|boolean \|undefined|-|-|Optional|
-|usesLegitimateInterest|boolean \|undefined|-|-|Optional|
-|dataRetention|Object \|undefined|-|-|Optional|
-|dataDeclaration|number\[] \|undefined|-|-|Optional|
-
-#### `dataRetention`
-
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|purposes|Record\<number, number> \|undefined|-|-|Optional|
-|specialPurposes|Record\<number, number> \|undefined|-|-|Optional|
-|stdRetention|number \|undefined|-|-|Optional|
-
-### ProcessedStack
-
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|number|-|-|✅ Required|
-|name|string|-|-|✅ Required|
-|description|string|-|-|✅ Required|
-|purposes|ProcessedPurpose|-|-|✅ Required|
-
-### ProcessedSpecialFeature
+> ℹ️ **Info:**
+> Until useGVLData() is exported as public API, avoid importing it from deep internal paths. Those paths are not covered by semver guarantees and can change without notice.
 
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|number|-|-|✅ Required|
-|name|string|-|-|✅ Required|
-|description|string|-|-|✅ Required|
-|descriptionLegal|string \|undefined|-|-|Optional|
-|illustrations|string\[]|-|-|✅ Required|
-|vendors|ProcessedVendor|-|-|✅ Required|
+When a public GVL-focused hook becomes part of the supported API, this page should document that public surface instead of the internal dialog hook.

package/docs/internationalization.md

@@ -10,7 +10,7 @@ There are two ways c15t can load translations: client-side or server-side.
 
 |Server-side|Client-side|
 |--|--|
-|The best way to reduce bundle size and improve performance. We can detect the user's language based on the browser's language settings, allowing for the most accurate translations. By default, when using a [consent.io](https://consent.io) hosted instance, [these languages](https://github.com/c15t/c15t/tree/main/packages/translations/src/translations) are supported.|Bundled with the application allowing for multiple languages to be supported without the need for a backend. The more translations you have, the larger the bundle size will be, which may impact the performance of your application.|
+|The best way to reduce bundle size and improve performance. We can detect the user's language based on the browser's language settings, allowing for the most accurate translations. By default, when using a [inth.com](https://inth.com) hosted instance, [these languages](https://github.com/c15t/c15t/tree/main/packages/translations/src/translations) are supported.|Bundled with the application allowing for multiple languages to be supported without the need for a backend. The more translations you have, the larger the bundle size will be, which may impact the performance of your application.|
 
 ## Basic Configuration
 

package/docs/optimization.md

@@ -1,10 +1,25 @@
 ---
 title: Optimization
 description: Improve c15t startup performance in React with prefetching, proxy rewrites, and rendering tradeoffs.
-lastModified: 2026-03-17
+lastModified: 2026-04-14
 ---
 Use this guide when you care about banner visibility speed, route static-ness, and reducing backend round-trip cost.
 
+## Start Here
+
+Apply the optimizations in this order:
+
+|Situation|Use|Why|Tradeoff|
+|--|--|--|--|
+|Any production app using hosted mode|Same-origin `/api/c15t` proxy|Lowers browser startup overhead and keeps the backend origin out of client config|Requires framework or platform proxy setup|
+|Banner speed matters on cold loads|`buildPrefetchScript()`|Starts `/init` before your app hydrates|Still a browser-side fetch, not SSR|
+|Your app navigates client-side|Keep the provider mounted at the app root|Avoids remounting and re-running init work|Requires provider placement discipline|
+|You cannot proxy and must stay cross-origin|`<link rel="preconnect">`|Starts DNS/TLS work earlier|Smaller gain than same-origin proxying|
+|You are using Next.js and want SSR or static-route-specific guidance|Next.js optimization docs|Covers `C15tPrefetch`, `fetchInitialData()`, and rendering tradeoffs|Next-specific|
+
+> ℹ️ **Info:**
+> Treat same-origin proxying as the baseline optimization. The others are situational layers you add when startup timing or route behavior justifies them.
+
 ## 1) Prefer Same-Origin Proxy
 
 Proxy c15t requests through your app server so the browser calls your own origin instead of a third-party domain.
@@ -23,6 +38,8 @@ Why this helps:
 * Ad blockers are less likely to block your init endpoint
 * You can change backend infrastructure without touching client code
 
+If you can only do one optimization, do this one first.
+
 ## 2) Prefetch Init Data Early
 
 Use `buildPrefetchScript()` from the `c15t` core package to start the `/init` request before your app hydrates. Inject the script as early as possible in your HTML `<head>`.
@@ -35,6 +52,12 @@ In production benchmarks with a same-origin rewrite, prefetching strategies show
 |Browser prefetch|\~1.3x faster|\~2.6x earlier|\~1.25x faster|
 |Server prefetch|\~2x faster|before page loads|\~1.9x faster|
 
+Use this when:
+
+* The app is client-rendered
+* You want a faster first banner without introducing SSR complexity
+* You control the HTML template or document `<head>`
+
 ### Inline Script Prefetch
 
 ```tsx
@@ -88,6 +111,8 @@ Why this helps:
 * Prevents extra callback churn from remount cycles
 * Keeps banner/dialog state stable between route transitions
 
+Mount `ConsentManagerProvider` as high in the tree as possible so route transitions do not recreate it.
+
 ## Animation Performance
 
 The default motion tokens are tuned for speed-first product UI:
@@ -104,6 +129,8 @@ To customize motion durations and easing, see [Styling](/docs/frameworks/react/s
 
 ## Reduce Network Overhead
 
+If your browser must call a cross-origin backend URL directly, add `preconnect` so the browser can warm up the connection earlier. This is a fallback optimization when same-origin proxying is not possible.
+
 If you must use a cross-origin backend URL, add preconnect so the browser starts DNS/TLS early:
 
 ```tsx
@@ -111,3 +138,10 @@ If you must use a cross-origin backend URL, add preconnect so the browser starts
   <link rel="preconnect" href="https://your-instance.c15t.dev" crossOrigin="" />
 </head>
 ```
+
+## Next.js-Specific SSR And Static Routes
+
+This page is intentionally React-generic. If you are using Next.js and need SSR or static-route-specific guidance:
+
+* See [Next.js Optimization](/docs/frameworks/next/optimization) for the static-vs-dynamic decision guide
+* See [Next.js Server-Side Data Fetching](/docs/frameworks/next/server-side) for `fetchInitialData()`

package/docs/policy-packs.md

@@ -13,7 +13,7 @@ When a backend isn't available — local development, static previews, Storybook
 
 ## Hosted Mode (Recommended)
 
-When using consent.io or a self-hosted backend, the provider connects automatically. No policy configuration is needed on the frontend:
+When using inth.com or a self-hosted backend, the provider connects automatically. No policy configuration is needed on the frontend:
 
 ```tsx
 <ConsentManagerProvider

package/docs/quickstart.md

@@ -17,10 +17,10 @@ availableIn:
 
 |Package manager|Command|
 |:--|:--|
-|npm|`npx @c15t/cli@rc`|
-|pnpm|`pnpm dlx @c15t/cli@rc`|
-|yarn|`yarn dlx @c15t/cli@rc`|
-|bun|`bunx @c15t/cli@rc`|
+|npm|`npx @c15t/cli`|
+|pnpm|`pnpm dlx @c15t/cli`|
+|yarn|`yarn dlx @c15t/cli`|
+|bun|`bunx @c15t/cli`|
 
 ## Manual Installation
 
@@ -39,7 +39,7 @@ availableIn:
    @import "@c15t/react/styles.css";
    ```
 
-   Keeping the c15t stylesheet in your global CSS entrypoint makes layer and cascade order explicit. JS/TSX side-effect imports can load in a different order across framework and Tailwind tooling, which makes style regressions harder to debug.
+   Keeping the c15t stylesheet in your global CSS entrypoint makes layer and cascade order explicit. JS/TSX side-effect imports can load in a different order across framework and Tailwind tooling, which makes style regressions harder to debug.With Tailwind v4, keep c15t at the end of the top-level @import block so Fumadocs, tw-animate-css, and other preset imports do not override c15t theme tokens.
 
    > ℹ️ Info:
    >
@@ -107,6 +107,9 @@ availableIn:
 
    A consent banner appears at the bottom of the pageClicking "Customize" opens a dialog with toggles for each consent categoryAfter accepting or rejecting, the banner dismisses and your choice persists across page reloads
 
+> ℹ️ **Info:**
+> Want to improve startup performance? See Optimization for the decision guide, prefetch setup, and network tuning.
+
 ## Optional: Add DevTools
 
 Install DevTools only if you want a runtime inspector while building and debugging:
@@ -142,10 +145,10 @@ Install c15t agent skills to let AI agents help with styling, i18n, scripts & ot
 
 |Package manager|Command|
 |:--|:--|
-|npm|`npx @c15t/cli@rc skills`|
-|pnpm|`pnpm dlx @c15t/cli@rc skills`|
-|yarn|`yarn dlx @c15t/cli@rc skills`|
-|bun|`bunx @c15t/cli@rc skills`|
+|npm|`npx @c15t/cli skills`|
+|pnpm|`pnpm dlx @c15t/cli skills`|
+|yarn|`yarn dlx @c15t/cli skills`|
+|bun|`bunx @c15t/cli skills`|
 
 See [AI Agents](/docs/ai-agents) for bundled package docs and agent skills.
 

package/docs/styling/color-scheme.md

@@ -65,7 +65,7 @@ function ThemeToggle() {
 
 ## How Dark Mode Works
 
-When dark mode is active, c15t applies the `dark` token values as CSS variable overrides. Only tokens specified in `dark` are overridden - unset tokens fall back to the `colors` values.
+When dark mode is active, c15t applies the `dark` token values as CSS variable overrides. Only tokens specified in `dark` are overridden - unset tokens fall back to the `colors` values. This also applies to `textOnPrimary`: if you omit it, c15t derives a readable foreground from the active `primary` color in that scheme.
 
 ```tsx
 const theme = {

package/docs/styling/css-variables.md

@@ -18,7 +18,7 @@ Every theme token is converted to a `--c15t-*` CSS custom property at runtime. Y
 |--c15t-border-hover|string \|undefined|\`colors.borderHover\` (default: \`hsl(0, 0%, 85%)\`)|-|Optional|
 |--c15t-text|string \|undefined|\`colors.text\` (default: \`hsl(0, 0%, 10%)\`)|-|Optional|
 |--c15t-text-muted|string \|undefined|\`colors.textMuted\` (default: \`hsl(0, 0%, 40%)\`)|-|Optional|
-|--c15t-text-on-primary|string \|undefined|\`colors.textOnPrimary\` (default: \`hsl(0, 0%, 100%)\`)|-|Optional|
+|--c15t-text-on-primary|string \|undefined|\`colors.textOnPrimary\` (auto-derived from \`colors.primary\` when omitted)|-|Optional|
 |--c15t-overlay|string \|undefined|\`colors.overlay\` (default: \`hsla(0, 0%, 0%, 0.5)\`)|-|Optional|
 |--c15t-switch-track|string \|undefined|\`colors.switchTrack\` (default: \`hsl(0, 0%, 85%)\`)|-|Optional|
 |--c15t-switch-track-active|string \|undefined|\`colors.switchTrackActive\` (default: \`hsl(228, 100%, 60%)\`)|-|Optional|