Skip to content

CDN — Vanilla HTML

The csszyx package ships a self-contained IIFE runtime that processes sz="..." attributes directly in vanilla HTML. Drop one <script> tag, write sz attributes the same way you would in JSX, and Tailwind classes appear at runtime.

This guide pairs with the VS Code Extension — same authoring experience (autocomplete, hover, syntax highlight) for sz= attributes in .html files.

<!DOCTYPE html>
<html>
<head>
<!-- 1. Tailwind v4 CDN — required (csszyx generates class names, Tailwind generates the CSS) -->
<script src="https://unpkg.com/@tailwindcss/browser@4"></script>
<!-- 2. csszyx runtime — pin to a specific version for production -->
<script src="https://unpkg.com/[email protected]"></script>
<!-- 3. Anti-FOUC — hide elements until the runtime has compiled them -->
<style>
[sz]:not(.sz-ready) { visibility: hidden; }
.sz-ready, .sz-ready [sz] { visibility: visible; }
</style>
</head>
<body sz="{ p: 8, bg: 'slate-950', color: 'slate-200', minH: 'screen' }">
<h1 sz="{ text: '4xl', weight: 'bold', color: 'blue-500', mb: 4 }">
Hello csszyx
</h1>
<p sz="{ text: 'lg', color: 'slate-400' }">
No bundler. No JSX. Just attributes.
</p>
</body>
</html>

The runtime walks the DOM, compiles each sz attribute into Tailwind class names, removes the sz attribute, then adds the resulting classes to the element’s class list. Tailwind v4’s JIT must see those classes after csszyx has written them, so the Tailwind script comes first in the <head>.

Order in <head>Result
Tailwind → csszyx✅ JIT picks up classes csszyx writes
csszyx → Tailwind❌ JIT scans before classes exist; styles missing

Always pin a specific version for production. CDN providers honor the unpkg and jsdelivr fields in package.json and serve the IIFE bundle directly at the package root URL:

<!-- unpkg -->
<script src="https://unpkg.com/[email protected]"></script>
<!-- jsdelivr -->
<script src="https://cdn.jsdelivr.net/npm/[email protected]"></script>

Avoid csszyx@latest in production — a major bump would silently break the page.

The package root serves the production bundle. It prints each problem it finds as a short line with the code, the values it names and a link to the code’s page:

[csszyx] sz-attribute-syntax: {"form":"char","input":"w: 1/2","char":"/","index":4} https://csszyx.com/e/sz-attribute-syntax

While you build the page, load browser.dev.iife.js instead. It prints the same problems as sentences with a help: line, and adds the warnings the production bundle leaves out, such as an unknown sz key. It is about 6.5 KB larger gzipped, so switch back before you publish:

<script src="https://unpkg.com/[email protected]/dist/browser.dev.iife.js"></script>

Without the anti-FOUC CSS, users see a flash of unstyled content while the runtime walks the DOM. The runtime adds sz-ready to <body> after the initial pass, so a single CSS rule eliminates the flash:

[sz]:not(.sz-ready) { visibility: hidden; }
.sz-ready, .sz-ready [sz] { visibility: visible; }

This is automatically injected by npx @csszyx/cli migrate public/ when converting an existing site — see Migrate.

Same as JSX sz={{ ... }}, but quoted as a single HTML attribute value. Use single quotes inside (HTML attribute is double-quoted):

<div sz="{ p: 4, bg: 'blue-500', hover: { bg: 'blue-600' } }">…</div>

Outer braces are optional — these are equivalent:

<div sz="{ p: 4, bg: 'red-500' }">…</div>
<div sz="p: 4, bg: 'red-500'">…</div>

The runtime auto-wraps when braces are missing, so the VS Code extension’s implicit syntax works out of the box.

Numbers, true, false, null and plain words (letters, digits, ., -, +) can go unquoted. Anything else is a string and needs single quotes — a fraction, a hex colour, a function:

<div sz="{ w: '1/2', bg: '#fff', h: 'calc(100%-2rem)' }">…</div>

Written unquoted (w: 1/2), the attribute does not parse: the runtime leaves that element unstyled, logs [csszyx] sz-attribute-syntax: with the character and its position, and carries on with the rest of the page.

The runtime installs a MutationObserver on <body>, so any element added later (by frameworks, scripts, fragment swaps, htmx, Alpine.js, etc.) is processed automatically:

const card = document.createElement('div');
card.setAttribute('sz', "{ p: 4, bg: 'emerald-500', rounded: 'lg' }");
document.body.appendChild(card);
// → runtime sees it, compiles sz → class, removes sz attr

The observer recurses into subtrees, so inserting a parent with [sz] descendants processes them all in one dispatch.

If you can’t depend on a public CDN, copy the bundle locally:

Terminal window
npm install [email protected]
cp node_modules/csszyx/dist/browser.iife.js public/csszyx.js

Then reference the local file:

<script src="/csszyx.js"></script>

The IIFE is fully self-contained — no other csszyx files needed.

  • No build-time mangling — class names are full Tailwind utilities (p-4, bg-blue-500, …), not the mangled z/y/x form. Mangling requires the build-time plugin pipeline, which doesn’t fit a CDN script.
  • Runtime evaluation is per-element — large pages with thousands of [sz] elements pay a per-element parse + transform cost on first load. For high-volume use, prefer the build-time plugin (csszyx/vite, csszyx/webpack).
  • Tailwind CDN is JIT-only — for production, ship a built Tailwind CSS file and serve it from your origin.

The repository ships a working demo at playground/vanilla-html/index.html covering object syntax, variants, dynamic elements, and the full anti-FOUC flow. Clone the repo and:

Terminal window
pnpm --filter @csszyx/playground-vanilla-html dev

Then open the URL the dev server prints.