One stylesheet for HTML your server renders. Utilities, plus the parts you'd usually pull in a JavaScript library for: dialogs, menus, drawers, tabs, tooltips and toasts, all working with scripts turned off.
That's example.html: one HTML file, this stylesheet, no script. Open it live, use it, then view its source.
Dark mode is included: two dark themes, ready to link.
The kit holds the structure: spacing, sizes, breakpoints and the parts. Your taste (colours, fonts, corner radius) goes in one small file of your own.
No build step and no framework. It fits Rails, Django, Laravel, htmx or a folder of HTML files as it is.
It's plain CSS, so it works in React, Vue or Svelte too. The interactive parts just don't need their JavaScript.
Docs, with every class and a live example: alloyhtml.com/docs
From a CDN:
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@alloyhtml/css@1/dist/alloy.min.css">Or from npm:
npm install @alloyhtml/css
and link node_modules/@alloyhtml/css/dist/alloy.min.css, or import the Sass
source with @use "@alloyhtml/css/scss/index".
dist/ has each file readable (alloy.css) and minified (alloy.min.css,
about 24KB gzipped).
<div class="container-960 padding-y-40">
<div class="bg-raised border border-subtle rounded-8 padding-24">
<h1 class="h4 font-weight-700 text-primary margin-bottom-8">Settings</h1>
<p class="text-body-2 text-secondary margin-bottom-20">Changes save when you press the button.</p>
<button type="button" commandfor="saved" command="show-modal"
class="button bg-primary-1 border-primary-1 text-white hover-bg-primary-2 hover-border-primary-2">Save</button>
</div>
</div>
<dialog id="saved" closedby="any" class="dialog bg-raised rounded-8 padding-24">
<p class="text-body-1 text-primary margin-bottom-16">Saved.</p>
<button type="button" commandfor="saved" command="close" class="button bg-surface border-subtle text-primary">Close</button>
</dialog>The button opens the dialog, and Esc or a click outside closes it. There's no script on the page.
Put your taste in one file, linked after the kit. Every colour, font and corner radius in the kit reads from these tokens, so the markup never changes:
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@alloyhtml/css@1/dist/alloy.min.css">
<link rel="stylesheet" href="/my-brand.css">/* my-brand.css */
:root {
/* Your brand: buttons, fills and brand text. 2 is hover, 3 pressed. */
--brand-primary-1: hsl(158, 80%, 29%);
--brand-primary-2: hsl(158, 82%, 25%);
--brand-primary-3: hsl(158, 85%, 21%);
/* Your fonts: load them yourself, then name them here. */
--font-family-base: 'Inter', system-ui, sans-serif;
--font-family-heading: 'Inter', system-ui, sans-serif;
/* Fields and buttons: their corners. 999px makes pills. */
--control-radius: 8px;
}That's the short version: a full brand also sets its tints and its dark-mode shades. Skip the file and you get the kit's defaults: a violet brand, the system font (Plus Jakarta Sans, if you load it) and 8px corners. The Themes & Brands page lists every token, and the theme builder at alloyhtml.com/themes writes the file for you.
Two dark themes come in the package, in dist/themes/: dark, a soft
graphite, and midnight, a soft navy. Link one after the kit.
To follow the visitor's device:
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@alloyhtml/css@1/dist/themes/dark.min.css" media="(prefers-color-scheme: dark)">Always dark, in midnight:
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@alloyhtml/css@1/dist/themes/midnight.min.css">A theme is a file of token values, like your brand file. To make your own, copy one of these and change the values.
Icons aren't included. The sizes (icon-16, icon-24) work with any icon
font.
The browser's own scrollbars stay unless you ask. For thin ones in the
theme's colours, put .scrollbar-thin on <html>, or on one scrolling box.
Some of the kit applies before you use a single class. In an app that already has its own CSS, these change:
- The reset: no margins on
body, headings, paragraphs and lists,border-boxsizing everywhere, images no wider than their box, tables with collapsed borders. bodytakes the kit's background, text colour and font, andh1toh6take its sizes, so anh1is 40px.- Links have no underline and take the colour of the text around them. Add
.ato a link to make it look like one. - Keyboard focus shows the kit's ring.
- The page stops scrolling while a modal
<dialog>is open. - A
<summary>that draws its own icon loses the browser's marker. - The page uses the light colour scheme, so the browser's own form controls stay light unless you link a dark theme.
Some names are common enough that your app may use them already: the classes
.button, .dialog, .field, .flex, .hidden, .tab, .tooltip and
.text-center, the animations fade-in, slide-in-up and zoom-in, and CSS variables
starting with --color- and --font-.
Where both define one, the stylesheet linked last wins.
Without Alloy, ask AI for ten pages and you get ten ideas of what a button is. With it, every page is written from the same classes and values.
The quick way, in any AI chat or agent:
Build an invoice page with Alloy CSS. Read alloyhtml.com/llms.txt first.
llms.txt is the rules and every class in one plain text file. To keep it in a project for good, use the skill:
ai/alloy-css/ is a Claude skill: the same rules in SKILL.md, and every
class with examples in reference.md. Add it to your project from its root:
npx @alloyhtml/css skill
That copies it into .claude/skills/alloy-css/, where Claude Code finds it.
Other tools (Cursor, Copilot, Codex) can read the same two files. Point your
AGENTS.md or rules file at .claude/skills/alloy-css/SKILL.md.
Then check what was written. alloy-check lists every class the kit
doesn't define, with its file and line, and fails when it finds one:
npx @alloyhtml/css check templates/
--css your.css adds your own stylesheet's classes, and --allow name
skips one, such as an icon font's.
Chrome and Edge 123, Firefox 125, Safari 17.5, and anything newer. The
interactive parts are built on popover, :has(), color-mix() and
light-dark(), which older browsers don't have.
Dialogs need newer still: the buttons that open and close them use
command and commandfor, from Chrome and Edge 135, Firefox 144 and
Safari 26.2. On an older browser the button that opens a dialog does
nothing. A click outside closes a dialog (closedby="any") from Safari
27.3; Esc and its close button work everywhere.
Alloy Templates are 82 pages built only with this kit: a shop and its back office, a blog, e-learning, news, healthcare booking, event tickets, a job portal and a company site. They're sold separately; the CSS is free.
MIT. See LICENSE.
