Code Block
Code to read and copy: file name, line numbers, highlighted lines and a monochrome syntax in weight and light. Copy rolls to Copied; a terminal copies its commands only.
View codeSmall labels: soft, solid, live, mono and a count that rolls. Remove a tag and it shrinks away while its neighbours glide to their new place, across lines too.
With your AI
Say it to your AI. It gets the exact code below, not its best guess, and knows where it goes.
Tag my blog posts with Kodza Badges.
claude mcp add -t http kodza https://kodza.dev/api/mcp
<div class="kodza-badge-row">
<span class="kodza-badge">Beta</span>
<span class="kodza-badge kodza-badge--solid">New</span>
<span class="kodza-badge kodza-badge--live">Live</span>
<span class="kodza-badge kodza-badge--mono">v2.0.1</span>
<span class="kodza-badge kodza-badge--count">Inbox <span class="kodza-badge__count" data-count="3">3</span></span>
</div>
<div class="kodza-badge-list" role="list" aria-label="Active filters">
<span class="kodza-badge kodza-badge--tag" role="listitem">flexbox<button class="kodza-badge__remove" type="button" aria-label="Remove flexbox"><svg viewBox="0 0 12 12" aria-hidden="true"><path d="M3.5 3.5l5 5M8.5 3.5l-5 5" /></svg></button></span>
<span class="kodza-badge kodza-badge--tag" role="listitem">grid<button class="kodza-badge__remove" type="button" aria-label="Remove grid"><svg viewBox="0 0 12 12" aria-hidden="true"><path d="M3.5 3.5l5 5M8.5 3.5l-5 5" /></svg></button></span>
<span class="kodza-badge kodza-badge--tag" role="listitem">no dependencies<button class="kodza-badge__remove" type="button" aria-label="Remove no dependencies"><svg viewBox="0 0 12 12" aria-hidden="true"><path d="M3.5 3.5l5 5M8.5 3.5l-5 5" /></svg></button></span>
<span class="kodza-badge kodza-badge--tag" role="listitem">dark mode<button class="kodza-badge__remove" type="button" aria-label="Remove dark mode"><svg viewBox="0 0 12 12" aria-hidden="true"><path d="M3.5 3.5l5 5M8.5 3.5l-5 5" /></svg></button></span>
<span class="kodza-badge kodza-badge--tag" role="listitem">vanilla JS<button class="kodza-badge__remove" type="button" aria-label="Remove vanilla JS"><svg viewBox="0 0 12 12" aria-hidden="true"><path d="M3.5 3.5l5 5M8.5 3.5l-5 5" /></svg></button></span>
</div>
/* Kodza License: free to use, client work included. Not to resell or redistribute, ported or not: https://kodza.dev/docs/#print-license */
/* Kodza — Badge
Small labels: soft (default), --solid, --live (a dot that breathes), --mono (a version, a
hash) and --count, whose number rolls when data-count changes. Tags (--tag) in a
.kodza-badge-list can be removed: the tag shrinks away and its neighbours glide to their new
place, across lines too. Monochrome: no color has to carry a meaning.
Everything is tuned with the --kz-badge-* variables. */
.kodza-badge-row,
.kodza-badge-list {
position: relative;
display: flex;
flex-wrap: wrap;
align-items: center;
gap: 8px;
}
.kodza-badge {
--kz-badge-fg: #0a0a0a;
--kz-badge-soft: rgba(10, 10, 10, 0.07);
--kz-badge-line: rgba(10, 10, 10, 0.16);
--kz-badge-ink: #0a0a0a;
--kz-badge-on-ink: #ffffff;
--kz-badge-ease: cubic-bezier(0.22, 1, 0.36, 1);
display: inline-flex;
align-items: center;
gap: 6px;
height: 26px;
padding: 0 10px;
border-radius: 999px;
background: var(--kz-badge-soft);
color: var(--kz-badge-fg);
font-size: 13px;
font-weight: 500;
line-height: 1;
white-space: nowrap;
}
.kodza-badge--solid {
background: var(--kz-badge-ink);
color: var(--kz-badge-on-ink);
}
.kodza-badge--mono {
background: none;
box-shadow: inset 0 0 0 1px var(--kz-badge-line);
font-family: "Geist Mono", ui-monospace, "SF Mono", Menlo, monospace;
font-size: 12px;
font-weight: 400;
}
/* Live: a dot, and a ring that leaves it now and then */
.kodza-badge--live::before {
content: "";
width: 6px;
height: 6px;
border-radius: 50%;
background: currentColor;
box-shadow: 0 0 0 0 var(--kz-badge-line);
animation: kodza-badge-live 1.8s cubic-bezier(0.22, 1, 0.36, 1) infinite;
}
@keyframes kodza-badge-live {
0% {
box-shadow: 0 0 0 0 var(--kz-badge-fg);
}
70%,
100% {
box-shadow: 0 0 0 7px transparent;
}
}
/* Count: the number sits in its own window and rolls */
.kodza-badge--count {
padding-right: 4px;
}
.kodza-badge__count {
display: inline-grid;
min-width: 18px;
height: 18px;
padding: 0 5px;
overflow: hidden;
box-sizing: border-box;
border-radius: 999px;
background: var(--kz-badge-ink);
color: var(--kz-badge-on-ink);
font-size: 11px;
font-weight: 600;
font-variant-numeric: tabular-nums;
line-height: 18px;
text-align: center;
}
.kodza-badge__count > span {
grid-area: 1 / 1;
}
/* Tag: a label you can take away */
.kodza-badge--tag {
height: 30px;
padding: 0 4px 0 12px;
font-size: 13px;
}
.kodza-badge__remove {
display: grid;
place-items: center;
width: 22px;
height: 22px;
padding: 0;
border: 0;
border-radius: 50%;
background: none;
color: inherit;
opacity: 0.6;
cursor: pointer;
transition: background-color 0.2s ease, opacity 0.2s ease;
}
.kodza-badge__remove:hover {
background: var(--kz-badge-soft);
opacity: 1;
}
.kodza-badge__remove:focus-visible {
outline: 2px solid var(--kz-badge-fg);
outline-offset: 1px;
opacity: 1;
}
.kodza-badge__remove svg {
width: 12px;
height: 12px;
fill: none;
stroke: currentColor;
stroke-width: 1.6;
stroke-linecap: round;
}
@media (prefers-reduced-motion: reduce) {
.kodza-badge--live::before {
animation: none;
}
.kodza-badge__remove {
transition-duration: 0.01ms !important;
}
}
/* Theming example — on a dark background:
.dark-section .kodza-badge {
--kz-badge-fg: #f2f2f0;
--kz-badge-soft: rgba(255, 255, 255, 0.1);
--kz-badge-line: rgba(255, 255, 255, 0.22);
--kz-badge-ink: #f2f2f0;
--kz-badge-on-ink: #0a0a0a;
}
*/
/* kodza-guard f7b047da951c — generated by Kodza, do not edit.
Theme guard: keeps a site's own CSS (WordPress themes, Bootstrap, CSS resets…) off this
component. :not(#_) is always true and weighs as much as an id, so these lines win over
theme rules made of classes and tags. Customise the component through its --kz-* variables. */
/* What the browser gives, where the component sets it only in some states: at the lowest weight, so its own rules below put it back */
:where(.kodza-badge__remove):not(#_) {
outline: revert;
outline-offset: revert;
}
/* What the browser gives, on everything the component leaves to it */
.kodza-badge-list:not(#_),
.kodza-badge:not(#_),
.kodza-badge__count span:where(:not([class*="kodza-"])):not(#_) {
box-sizing: revert;
}
.kodza-badge__remove:not(#_) {
margin: revert;
text-decoration: revert;
list-style: revert;
box-sizing: revert;
float: revert;
position: revert;
box-shadow: revert;
appearance: revert;
max-width: revert;
max-height: revert;
font-family: revert;
font-size: revert;
font-weight: revert;
font-style: revert;
line-height: revert;
letter-spacing: revert;
text-transform: revert;
text-underline-offset: revert;
text-align: revert;
text-indent: revert;
text-shadow: revert;
vertical-align: revert;
white-space: revert;
min-height: revert;
}
.kodza-badge__remove svg:where(:not([class*="kodza-"])):not(#_) {
border: revert;
margin: revert;
padding: revert;
border-radius: revert;
outline: revert;
text-decoration: revert;
transition: revert;
list-style: revert;
box-sizing: revert;
float: revert;
position: revert;
background-color: revert;
background-image: revert;
box-shadow: revert;
outline-offset: revert;
appearance: revert;
max-width: revert;
max-height: revert;
color: revert;
font-family: revert;
font-size: revert;
font-weight: revert;
font-style: revert;
line-height: revert;
letter-spacing: revert;
text-transform: revert;
text-underline-offset: revert;
text-align: revert;
text-indent: revert;
text-shadow: revert;
vertical-align: revert;
}
.kodza-badge__remove svg:where(:not([class*="kodza-"])):not(#_):where(:not([hidden])) {
display: revert;
}
.kodza-badge__remove svg:where(:not([class*="kodza-"])):not(#_):where([hidden]) {
display: none;
}
/* The component's own rules, one step stronger: real buttons and fields, what it sets on tags themes style (links, lists, headings, images…), and the root width (a theme may narrow it, never widen it) */
.kodza-badge__remove:not(#_) {
display: grid;
place-items: center;
width: 22px;
height: 22px;
padding: 0;
border: 0;
border-radius: 50%;
background: none;
color: inherit;
opacity: 0.6;
cursor: pointer;
transition: background-color 0.2s ease, opacity 0.2s ease;
}
.kodza-badge__remove:hover:not(#_) {
background: var(--kz-badge-soft);
opacity: 1;
}
.kodza-badge__remove:focus-visible:not(#_) {
outline: 2px solid var(--kz-badge-fg);
outline-offset: 1px;
opacity: 1;
}
@media (prefers-reduced-motion: reduce) {
.kodza-badge__remove:not(#_) {
transition-duration: 0.01ms !important;
}
}
// Kodza License: free to use, client work included. Not to resell or redistribute, ported or not: https://kodza.dev/docs/#print-license
// Kodza — Badge
// Rolls a count to its new number when data-count changes, and removes tags: the tag shrinks
// away from its place while its neighbours glide to theirs (measured before and after, in the
// list's own pixels). A removed tag sends "kodza:badge-remove"; focus goes to the next one.
(() => {
const SELECTOR = '.kodza-badge__count, .kodza-badge-list';
const reduceMotion = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
const ease = 'cubic-bezier(0.22, 1, 0.36, 1)';
// A count: rolls to its new number
function mountCount(count, signal) {
let current = count.dataset.count || count.textContent.trim();
count.replaceChildren(Object.assign(document.createElement('span'), { textContent: current }));
const observer = new MutationObserver(() => {
const next = count.dataset.count;
if (next === current) return;
const up = parseFloat(next) >= parseFloat(current);
current = next;
const old = count.lastElementChild;
const span = Object.assign(document.createElement('span'), { textContent: next });
count.append(span);
if (reduceMotion) return old.remove();
const timing = { duration: 420, easing: ease };
old.animate([{ transform: 'none' }, { transform: `translateY(${up ? -110 : 110}%)` }], { ...timing, fill: 'forwards' }).finished.then(() => old.remove());
span.animate([{ transform: `translateY(${up ? 110 : -110}%)` }, { transform: 'none' }], timing);
});
observer.observe(count, { attributes: true, attributeFilter: ['data-count'] });
signal.addEventListener('abort', () => observer.disconnect());
}
// A list of tags: removes them
function mountList(list, signal) {
list.addEventListener('click', (event) => {
const button = event.target.closest('.kodza-badge__remove');
const tag = button?.closest('.kodza-badge');
if (!tag || tag.classList.contains('is-leaving')) return;
const tags = [...list.querySelectorAll('.kodza-badge:not(.is-leaving)')];
const next = tags[tags.indexOf(tag) + 1] || tags[tags.indexOf(tag) - 1];
const keyboard = button.matches(':focus-visible');
const done = () => {
if (signal.aborted) return;
// Back to a plain tag (while still in the page, where its animations are found), so it
// can be put back
tag.getAnimations().forEach((animation) => animation.cancel());
tag.remove();
tag.classList.remove('is-leaving');
Object.assign(tag.style, { position: '', left: '', top: '', margin: '', pointerEvents: '' });
list.dispatchEvent(new CustomEvent('kodza:badge-remove', { bubbles: true, detail: { tag } }));
};
if (keyboard) next?.querySelector('.kodza-badge__remove')?.focus();
if (reduceMotion) return done();
// The tag leaves the flow where it stands; the others glide to their new place
const k = list.getBoundingClientRect().width / list.offsetWidth || 1;
const others = tags.filter((other) => other !== tag);
const before = new Map(others.map((other) => [other, other.getBoundingClientRect()]));
const box = tag.getBoundingClientRect();
const origin = list.getBoundingClientRect();
tag.classList.add('is-leaving');
Object.assign(tag.style, { position: 'absolute', left: `${(box.left - origin.left) / k}px`, top: `${(box.top - origin.top) / k}px`, margin: '0', pointerEvents: 'none' });
others.forEach((other) => {
const was = before.get(other);
const now = other.getBoundingClientRect();
const dx = (was.left - now.left) / k;
const dy = (was.top - now.top) / k;
if (dx || dy) other.animate([{ transform: `translate(${dx}px, ${dy}px)` }, { transform: 'none' }], { duration: 560, delay: 60, easing: ease, fill: 'backwards' });
});
tag.animate([
{ opacity: 1, transform: 'none' },
{ opacity: 0, transform: 'scale(0.6)' },
], { duration: 260, easing: 'cubic-bezier(0.4, 0, 1, 1)', fill: 'forwards' }).onfinish = done;
}, { signal });
}
// One instance. Everything it starts is tied to `signal`, so kodza:destroy stops it all
function mount(root, signal) {
if (root.classList.contains('kodza-badge-list')) mountList(root, signal);
else mountCount(root, signal);
}
// Kodza lifecycle, the same in every component: `kodza:init` starts the instances inside
// event.detail.root (the whole page by default), `kodza:destroy` stops them and puts their
// markup back. For themes and apps that swap content without a page load.
const instances = new WeakMap();
const find = (scope = document) => [scope, ...scope.querySelectorAll(SELECTOR)].filter((el) => el.matches?.(SELECTOR));
const init = (scope) => find(scope).forEach((root) => {
if (root.classList.contains('is-ready')) return; // already running, maybe from another copy of this script
const controller = new AbortController();
instances.set(root, { controller, html: root.innerHTML, attrs: [...root.attributes].map((a) => [a.name, a.value]) });
mount(root, controller.signal);
root.classList.add('is-ready');
});
const destroy = (scope) => find(scope).forEach((root) => {
const instance = instances.get(root);
if (!instance) return;
instances.delete(root);
instance.controller.abort();
[...root.attributes].forEach((a) => root.removeAttribute(a.name));
instance.attrs.forEach(([name, value]) => root.setAttribute(name, value));
root.innerHTML = instance.html;
});
document.addEventListener('kodza:init', (event) => init(event.detail?.root));
document.addEventListener('kodza:destroy', (event) => destroy(event.detail?.root));
init();
// Loaded in <head>, the script runs before the markup exists: once more when it is parsed
if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', () => init(), { once: true });
})();
'use client';
// Kodza — Badge, for React. From https://kodza.dev/components/badge/
// Kodza License: free to use, client work included. Not to resell or redistribute, ported or not: https://kodza.dev/docs/#print-license
// Next to this file: badge.css and badge.js, the component's CSS and JS from Kodza, as they are.
// Yours to edit: the markup is plain JSX below.
// The script changes this markup once React has rendered it (it adds layers, splits text, moves
// nodes), so React must not patch it afterwards. When a prop changes, the key gives React a fresh
// element: kodza:destroy stops the script on the old one, kodza:init starts it on the new one.
import { useRef, useEffect, type ComponentPropsWithoutRef, type ComponentRef } from 'react';
import './badge.css';
export type BadgeProps = Omit<ComponentPropsWithoutRef<'div'>, "children" | "onBadgeRemove"> & {
/** "kodza:badge-remove", fired by the script (bubbles from the root) */
onBadgeRemove?: (event: CustomEvent) => void;
className?: string;
};
export function Badge({ onBadgeRemove, className, style, ...rest }: BadgeProps) {
const ref = useRef<ComponentRef<'div'>>(null);
const classes = ["kodza-badge-list", className].filter(Boolean).join(' ');
// Everything the markup is made of: when it changes, React gets a fresh element (see the top)
const key = JSON.stringify([classes, style, rest]);
// Starts the script on this element once React has rendered it, stops it when it goes
useEffect(() => {
const root = ref.current;
let live = true;
// @ts-ignore: a plain script, no types to find
import('./badge.js').then(() => {
if (live) document.dispatchEvent(new CustomEvent('kodza:init', { detail: { root } }));
});
return () => {
live = false;
document.dispatchEvent(new CustomEvent('kodza:destroy', { detail: { root } }));
};
}, [key]);
useEffect(() => {
const root = ref.current;
if (!root || !onBadgeRemove) return;
const listener = (event: Event) => onBadgeRemove(event as CustomEvent);
root.addEventListener("kodza:badge-remove", listener);
return () => root.removeEventListener("kodza:badge-remove", listener);
}, [onBadgeRemove, key]);
return (
<div role="list" aria-label="Active filters" key={key} {...rest} className={classes} style={style} ref={ref}>
<span className="kodza-badge kodza-badge--tag" role="listitem">flexbox<button className="kodza-badge__remove" type="button" aria-label="Remove flexbox"> <svg viewBox="0 0 12 12" aria-hidden="true"> <path d="M3.5 3.5l5 5M8.5 3.5l-5 5" /> </svg> </button></span>
{' '}
<span className="kodza-badge kodza-badge--tag" role="listitem">grid<button className="kodza-badge__remove" type="button" aria-label="Remove grid"> <svg viewBox="0 0 12 12" aria-hidden="true"> <path d="M3.5 3.5l5 5M8.5 3.5l-5 5" /> </svg> </button></span>
{' '}
<span className="kodza-badge kodza-badge--tag" role="listitem">no dependencies<button className="kodza-badge__remove" type="button" aria-label="Remove no dependencies"> <svg viewBox="0 0 12 12" aria-hidden="true"> <path d="M3.5 3.5l5 5M8.5 3.5l-5 5" /> </svg> </button></span>
{' '}
<span className="kodza-badge kodza-badge--tag" role="listitem">dark mode<button className="kodza-badge__remove" type="button" aria-label="Remove dark mode"> <svg viewBox="0 0 12 12" aria-hidden="true"> <path d="M3.5 3.5l5 5M8.5 3.5l-5 5" /> </svg> </button></span>
{' '}
<span className="kodza-badge kodza-badge--tag" role="listitem">vanilla JS<button className="kodza-badge__remove" type="button" aria-label="Remove vanilla JS"> <svg viewBox="0 0 12 12" aria-hidden="true"> <path d="M3.5 3.5l5 5M8.5 3.5l-5 5" /> </svg> </button></span>
</div>
);
}
Checked
Robots poked at it before you did. Every component goes through the same checks, and again each time it changes.