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 codeA live countdown to a date: every digit that changes falls out of its window as the next one drops in, and at zero the figures step aside for your message. Large or inline.
With your AI
Say it to your AI. It gets the exact code below, not its best guess, and knows where it goes.
Add a Kodza Countdown to my launch date.
claude mcp add -t http kodza https://kodza.dev/api/mcp
<div class="kodza-countdown" role="timer" data-date="2027-01-01T00:00:00" data-done="Happy new year. Ship something.">
<div class="kodza-countdown__units">
<span class="kodza-countdown__unit"><span class="kodza-countdown__value" data-unit="days">00</span><span class="kodza-countdown__label">Days</span></span>
<span class="kodza-countdown__sep" aria-hidden="true">:</span>
<span class="kodza-countdown__unit"><span class="kodza-countdown__value" data-unit="hours">00</span><span class="kodza-countdown__label">Hours</span></span>
<span class="kodza-countdown__sep" aria-hidden="true">:</span>
<span class="kodza-countdown__unit"><span class="kodza-countdown__value" data-unit="minutes">00</span><span class="kodza-countdown__label">Minutes</span></span>
<span class="kodza-countdown__sep" aria-hidden="true">:</span>
<span class="kodza-countdown__unit"><span class="kodza-countdown__value" data-unit="seconds">00</span><span class="kodza-countdown__label">Seconds</span></span>
</div>
</div>
<p class="kodza-countdown kodza-countdown--inline" role="timer" data-date="2027-01-01T00:00:00" data-done="Early bird is gone.">
<span class="kodza-countdown__units">Early bird ends in <span class="kodza-countdown__clock"><span class="kodza-countdown__value" data-unit="hours">00</span><span class="kodza-countdown__colon">:</span><span class="kodza-countdown__value" data-unit="minutes">00</span><span class="kodza-countdown__colon">:</span><span class="kodza-countdown__value" data-unit="seconds">00</span></span></span>
</p>
/* Kodza License: free to use, client work included. Not to resell or redistribute, ported or not: https://kodza.dev/docs/#print-license */
/* Kodza — Countdown
A live countdown to data-date. Counting down, every digit that changes falls: the old one
drops out of its window as the new one comes from above. At zero the figures step aside
for data-done. Large (days, hours, minutes, seconds) or --inline, in a sentence. Without
days, the hours add them up. Screen readers get a sentence, refreshed every minute.
Everything is tuned with the --kz-countdown-* variables. */
.kodza-countdown {
--kz-countdown-fg: #0a0a0a;
--kz-countdown-muted: rgba(10, 10, 10, 0.62);
--kz-countdown-soft: rgba(10, 10, 10, 0.07);
--kz-countdown-chip: #ffffff;
--kz-countdown-size: clamp(44px, 7vw, 84px);
--kz-countdown-ease: cubic-bezier(0.22, 1, 0.36, 1);
display: inline-grid;
margin: 0;
color: var(--kz-countdown-fg);
}
.kodza-countdown__units,
.kodza-countdown__done {
grid-area: 1 / 1;
transition: transform 0.7s var(--kz-countdown-ease), opacity 0.4s ease, visibility 0s;
}
.kodza-countdown__units {
display: flex;
align-items: flex-start;
gap: 14px;
}
.kodza-countdown__unit {
display: grid;
justify-items: center;
gap: 10px;
}
.kodza-countdown__value {
display: inline-flex;
font-size: var(--kz-countdown-size);
font-weight: 600;
font-variant-numeric: tabular-nums;
line-height: 1;
letter-spacing: -0.05em;
}
/* Each digit in its own window, where it falls */
.kodza-countdown__digit {
display: inline-grid;
overflow: hidden;
padding-block: 0.06em;
margin-block: -0.06em;
}
.kodza-countdown__digit > span {
grid-area: 1 / 1;
}
.kodza-countdown__label {
color: var(--kz-countdown-muted);
font-family: "Geist Mono", ui-monospace, "SF Mono", Menlo, monospace;
font-size: 11px;
letter-spacing: 0.08em;
text-transform: uppercase;
}
.kodza-countdown__sep {
color: var(--kz-countdown-muted);
font-size: calc(var(--kz-countdown-size) * 0.7);
font-weight: 300;
line-height: 1.2;
}
/* At zero: the figures step aside, the message rises */
.kodza-countdown__done {
align-self: center;
font-size: calc(var(--kz-countdown-size) * 0.42);
font-weight: 600;
letter-spacing: -0.03em;
opacity: 0;
transform: translateY(40%);
visibility: hidden;
transition: transform 0.6s var(--kz-countdown-ease), opacity 0.35s ease, visibility 0s linear 0.6s;
}
/* What leaves stays visible until it has left */
.kodza-countdown.is-done .kodza-countdown__units {
opacity: 0;
transform: translateY(-30%);
visibility: hidden;
transition: transform 0.7s var(--kz-countdown-ease), opacity 0.4s ease, visibility 0s linear 0.7s;
}
.kodza-countdown.is-done .kodza-countdown__done {
opacity: 1;
transform: none;
visibility: visible;
transition: transform 0.8s var(--kz-countdown-ease) 0.15s, opacity 0.5s ease 0.15s, visibility 0s;
}
/* Inline: a chip, the words then the time in a small mono pill, all centred on one line */
.kodza-countdown--inline {
--kz-countdown-size: 13px;
padding: 5px 5px 5px 16px;
border-radius: 999px;
background: var(--kz-countdown-soft);
font-size: 14px;
font-weight: 500;
line-height: 1;
}
.kodza-countdown--inline .kodza-countdown__units {
display: flex;
align-items: center;
gap: 10px;
white-space: nowrap;
}
.kodza-countdown__clock {
display: inline-flex;
align-items: center;
height: 28px;
padding: 0 11px;
border-radius: 999px;
background: var(--kz-countdown-chip, #ffffff);
box-shadow: inset 0 0 0 1px var(--kz-countdown-soft);
font-family: "Geist Mono", ui-monospace, "SF Mono", Menlo, monospace;
font-variant-numeric: tabular-nums;
}
.kodza-countdown--inline .kodza-countdown__value {
font-family: inherit;
font-weight: 500;
letter-spacing: 0;
line-height: 1.2;
}
.kodza-countdown__colon {
margin: 0 -1px;
color: var(--kz-countdown-muted);
}
.kodza-countdown--inline .kodza-countdown__done {
justify-self: center;
padding-right: 11px;
font-size: 14px;
font-weight: 500;
letter-spacing: 0;
}
.kodza-countdown__sr {
position: absolute;
width: 1px;
height: 1px;
overflow: hidden;
clip: rect(0 0 0 0);
white-space: nowrap;
}
@media (max-width: 560px) {
.kodza-countdown__units {
gap: 8px;
}
.kodza-countdown:not(.kodza-countdown--inline) {
--kz-countdown-size: 40px;
}
}
@media (prefers-reduced-motion: reduce) {
.kodza-countdown__units,
.kodza-countdown__done {
transition-duration: 0.01ms !important;
}
}
/* Theming example — on a dark background:
.dark-section .kodza-countdown {
--kz-countdown-fg: #f2f2f0;
--kz-countdown-muted: rgba(242, 242, 240, 0.62);
--kz-countdown-soft: rgba(255, 255, 255, 0.08);
--kz-countdown-chip: #1c1c1c;
}
*/
/* kodza-guard 6be0046f1761 — 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-countdown):not(#_) {
padding: revert;
border-radius: revert;
background-color: revert;
background-image: revert;
font-size: revert;
font-weight: revert;
line-height: revert;
}
/* What the browser gives, on everything the component leaves to it */
.kodza-countdown:not(#_) {
border: revert;
outline: revert;
text-decoration: revert;
transition: revert;
list-style: revert;
box-sizing: revert;
position: revert;
box-shadow: revert;
outline-offset: revert;
appearance: revert;
max-height: revert;
font-family: revert;
font-style: revert;
letter-spacing: revert;
text-transform: revert;
text-underline-offset: revert;
text-align: revert;
text-indent: revert;
text-shadow: revert;
vertical-align: revert;
}
.kodza-countdown__units:not(#_),
.kodza-countdown__unit:not(#_),
.kodza-countdown__value:not(#_),
.kodza-countdown__digit:not(#_),
.kodza-countdown__label:not(#_),
.kodza-countdown__sep:not(#_),
.kodza-countdown__done:not(#_),
.kodza-countdown__sr:not(#_),
.kodza-countdown__clock:not(#_),
.kodza-countdown__colon:not(#_),
.kodza-countdown__digit span:where(:not([class*="kodza-"])):not(#_) {
box-sizing: revert;
}
/* 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-countdown:where(p):not(#_) {
display: inline-grid;
color: var(--kz-countdown-fg);
}
.kodza-countdown--inline:not(#_) {
padding: 5px 5px 5px 16px;
border-radius: 999px;
background: var(--kz-countdown-soft);
font-size: 14px;
font-weight: 500;
line-height: 1;
}
// Kodza License: free to use, client work included. Not to resell or redistribute, ported or not: https://kodza.dev/docs/#print-license
// Kodza — Countdown
// Ticks on the second towards data-date, rolls down every digit that changes, and switches to
// data-done at zero. Change data-date and it follows. Screen readers get "3 days, 4 hours,
// 12 minutes left" (updated once a minute, not every second).
(() => {
const SELECTOR = '.kodza-countdown';
const reduceMotion = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
const ease = 'cubic-bezier(0.22, 1, 0.36, 1)';
const SPAN = { days: 86400, hours: 3600, minutes: 60, seconds: 1 };
// One instance. Everything it starts is tied to `signal`, so kodza:destroy stops it all
function mount(root, signal) {
const values = [...root.querySelectorAll('.kodza-countdown__value')];
const units = root.querySelector('.kodza-countdown__units');
const hasDays = values.some((el) => el.dataset.unit === 'days');
let timer = 0;
let said = '';
units.setAttribute('aria-hidden', 'true');
const sr = Object.assign(document.createElement('span'), { className: 'kodza-countdown__sr' });
const done = Object.assign(document.createElement('span'), { className: 'kodza-countdown__done', textContent: root.dataset.done || '' });
root.append(done, sr);
// A value is a row of digit windows; a digit that changes drops out, the new one comes from above
const show = (el, text, animate) => {
const cells = [...el.children];
if (cells.length !== text.length) {
el.replaceChildren(...[...text].map((char) => {
const cell = Object.assign(document.createElement('span'), { className: 'kodza-countdown__digit' });
cell.append(Object.assign(document.createElement('span'), { textContent: char }));
return cell;
}));
return;
}
[...text].forEach((char, i) => {
const cell = cells[i];
const old = cell.lastElementChild;
if (old.textContent === char) return;
const next = Object.assign(document.createElement('span'), { textContent: char });
cell.append(next);
if (!animate || reduceMotion) return old.remove();
const timing = { duration: 520, easing: ease };
old.animate([{ transform: 'none', opacity: 1 }, { transform: 'translateY(100%)', opacity: 0 }], { ...timing, fill: 'forwards' }).finished.then(() => old.remove());
next.animate([{ transform: 'translateY(-100%)', opacity: 0 }, { transform: 'none', opacity: 1 }], timing);
});
};
const tick = (animate = true) => {
clearTimeout(timer);
const target = new Date(root.dataset.date).getTime();
if (Number.isNaN(target)) return;
let left = Math.max(0, Math.round((target - Date.now()) / 1000));
const over = left === 0;
if (!over) root.classList.remove('is-done');
const parts = {};
['days', 'hours', 'minutes', 'seconds'].forEach((unit) => {
if (unit === 'days' && !hasDays) return;
parts[unit] = Math.floor(left / SPAN[unit]);
left -= parts[unit] * SPAN[unit];
});
values.forEach((el) => show(el, String(parts[el.dataset.unit] ?? 0).padStart(2, '0'), animate));
const sentence = over
? root.dataset.done || 'Time is up'
: `${hasDays ? `${parts.days} days, ` : ''}${parts.hours} hours, ${parts.minutes} minutes left`;
if (sentence !== said) sr.textContent = said = sentence;
// At zero, 00 lands first, then the message takes over
if (over) {
if (root.dataset.done && !root.classList.contains('is-done')) timer = setTimeout(() => root.classList.add('is-done'), animate && !reduceMotion ? 900 : 0);
return;
}
timer = setTimeout(tick, 1000 - (Date.now() % 1000) + 10);
};
tick(false);
const observer = new MutationObserver(() => tick());
observer.observe(root, { attributes: true, attributeFilter: ['data-date'] });
signal.addEventListener('abort', () => {
observer.disconnect();
clearTimeout(timer);
});
}
// 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 — Countdown, for React. From https://kodza.dev/components/event-day-counter/
// 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: event-day-counter.css and event-day-counter.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, type CSSProperties } from 'react';
import './event-day-counter.css';
type Variant = "inline";
export type CountdownProps = Omit<ComponentPropsWithoutRef<'div'>, "children" | "variant" | "vars" | "date" | "done"> & {
/** Modifier class(es): .kodza-countdown--inline */
variant?: Variant | Variant[];
/** data-date on the root (default: 2027-01-01T00:00:00) */
date?: "2027-01-01T00:00:00";
/** data-done on the root (default: Happy new year. Ship something.) */
done?: "Happy new year. Ship something." | "Early bird is gone.";
/** Settings, as CSS variables on the root */
vars?: {
/** default: #0a0a0a */
"--kz-countdown-fg"?: string | number;
/** default: rgba(10, 10, 10, 0.62) */
"--kz-countdown-muted"?: string | number;
/** default: rgba(10, 10, 10, 0.07) */
"--kz-countdown-soft"?: string | number;
/** default: #ffffff */
"--kz-countdown-chip"?: string | number;
/** default: clamp(44px, 7vw, 84px) */
"--kz-countdown-size"?: string | number;
/** default: cubic-bezier(0.22, 1, 0.36, 1) */
"--kz-countdown-ease"?: string | number;
};
className?: string;
};
export function Countdown({ variant, date = "2027-01-01T00:00:00", done = "Happy new year. Ship something.", vars, className, style, ...rest }: CountdownProps) {
const ref = useRef<ComponentRef<'div'>>(null);
const classes = ["kodza-countdown", ...([] as string[]).concat(variant ?? []).map((v) => `kodza-countdown--${v}`), 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, date, done, vars, 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('./event-day-counter.js').then(() => {
if (live) document.dispatchEvent(new CustomEvent('kodza:init', { detail: { root } }));
});
return () => {
live = false;
document.dispatchEvent(new CustomEvent('kodza:destroy', { detail: { root } }));
};
}, [key]);
return (
<div role="timer" key={key} {...rest} className={classes} data-date={date} data-done={done} style={{ ...vars, ...style } as CSSProperties} ref={ref}>
<div className="kodza-countdown__units">
<span className="kodza-countdown__unit">
<span className="kodza-countdown__value" data-unit="days">00</span>
<span className="kodza-countdown__label">Days</span>
</span>
{' '}
<span className="kodza-countdown__sep" aria-hidden="true">:</span>
{' '}
<span className="kodza-countdown__unit">
<span className="kodza-countdown__value" data-unit="hours">00</span>
<span className="kodza-countdown__label">Hours</span>
</span>
{' '}
<span className="kodza-countdown__sep" aria-hidden="true">:</span>
{' '}
<span className="kodza-countdown__unit">
<span className="kodza-countdown__value" data-unit="minutes">00</span>
<span className="kodza-countdown__label">Minutes</span>
</span>
{' '}
<span className="kodza-countdown__sep" aria-hidden="true">:</span>
{' '}
<span className="kodza-countdown__unit">
<span className="kodza-countdown__value" data-unit="seconds">00</span>
<span className="kodza-countdown__label">Seconds</span>
</span>
</div>
</div>
);
}
Checked
Robots poked at it before you did. Every component goes through the same checks, and again each time it changes.