# Installing Kockica on a website — instructions for AI coding agents
_This file is for agents installing Kockica on a site. Agents developing Kockica itself: see `CLAUDE.md`._
You were asked to add Kockica (`@datavallis/consent`) to a project. Follow these steps in order. The README in this
package is the full reference (options, Next.js, limits); this file is the procedure.
Kockica is a cookie consent banner: it detects and blocks known trackers until the visitor consents, runs Google
Consent Mode v2, builds the cookie table for the policy page and speaks 22 languages
(en, sl, de, hr, it, fr, es, pt, nl, da, pl, cs, sk, hu, bg, uk, ru, el, sq, sv, fi, nb; `no` / `nn` map to `nb`).
Work on a branch and deploy to a development/staging environment only. Never deploy to production yourself.
## 1. Survey first, report before changing code
- **Stack:** Next.js (App or Pages Router), another bundler app (React, Vue, Svelte, Nuxt …), WordPress, static HTML, other.
- **Languages:** which languages the site has, how `` is set (must be the 2-letter code: `en`, `de`, `uk` not
`ua`, `sq`, `el`), and the cookie / privacy policy URL for **each** language.
- **Existing cookie banners:** search for `cookieyes`, `cky-`, `cookiebot`, `CookieConsent`, `onetrust`, `iubenda`,
`complianz`, `cookie-law-info`, `klaro`, `osano`, `usercentrics`.
- **Trackers and embeds:** GA4 / gtag, Google Tag Manager, Google Ads, AdSense, Meta Pixel, Hotjar, Microsoft Clarity,
LinkedIn Insight, TikTok Pixel, YouTube, Vimeo, Google Maps, anything else — and **how** each is loaded (raw
`
```
Replace `0.5` with the current major.minor (`npm view @datavallis/consent version`). On multilingual sites, output the page's own policy URL in
`data-policy-url` from the template. List only languages the site really has.
## 4. Trackers and embeds
- Known trackers (GA4, Google Ads, GTM, Meta Pixel, Hotjar, Clarity, LinkedIn Insight, TikTok Pixel, YouTube, Vimeo,
Google Maps) are detected and blocked automatically. Load them normally (Next.js: `next/script`, strategy
`afterInteractive` or later).
- Never leave a tracker `