Status: [LIVE] Endpoints found: https://yoursite.com/api/agent Source: https://github.com/Vedanshu7/clicksplain # clicksplain [![npm version](https://img.shields.io/npm/v/clicksplain.svg)](https://www.npmjs.com/package/clicksplain) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE) A drop-in, AI-powered "explain this UI" widget. Click the "?" button, then click any element on the page to get an LLM-generated explanation of what it does: rendered in an animated popover anchored to the element. 100% client-side library, no backend we run. Ships two ways to connect an LLM: - **BYOK**: pass a raw API key directly (dev/prototyping only, key is visible in the browser). - **BYO-endpoint**: point at your own tiny proxy (recommended for production). Reference templates for Cloudflare Workers and Vercel Edge Functions are in `examples/`. ## Quick start ```html ``` Or via npm: ```bash npm install clicksplain ``` See `examples/demo-host-page/` for a working local demo of both connector modes. ## Theming Every color, radius, and font in the widget (fab, cursor badge, hover highlight box, popover, chat) is a CSS custom property, and custom properties inherit through the widget's Shadow DOM boundary, so your site's own CSS can restyle it with zero JavaScript: ```css /* your site's own stylesheet: no clicksplain-specific setup needed */ :root { --clicksplain-accent: #16a34a; /* fab, active states, links, send button */ --clicksplain-accent-active: #15803d; /* hover/active shade of the accent */ --clicksplain-accent-contrast: #fff; /* text/icon color drawn on top of the accent */ --clicksplain-surface: #052e16; /* popover/panel background */ --clicksplain-border: rgba(34, 197, 94, 0.35); /* hairlines, dividers, subtle fills */ --clicksplain-text: #dcfce7; /* body text color */ --clicksplain-danger: #dc2626; /* er