Skip to content

ProfPowell/vanilla-breeze

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,729 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Vanilla Breeze

A layered HTML component system extending HTML's native model. Build accessible, themeable interfaces with semantic HTML, CSS cascade layers, and progressive enhancement — no build step required.

Features

  • Zero-class styling — native HTML elements styled through cascade layers, not utility classes
  • Layout attributes — responsive layouts via data-layout="stack | cluster | sidebar | grid" instead of wrapper divs
  • 30+ web components — accordion, tabs, carousel, data-table, command-palette, combo-box, toast, tooltip, drag-surface, and more
  • Design tokens — spacing, typography, colors, sizing, borders, shadows, motion
  • Theme engine — 40+ themes as tiny à-la-carte token files (1–4 KB each), plus dark/light mode; only core themes ship in the main bundle
  • Progressive enhancement — everything works without JavaScript; JS adds interactivity

Quick Start

CDN

<link rel="stylesheet" href="https://unpkg.com/vanilla-breeze/dist/cdn/vanilla-breeze.css">
<script type="module" src="https://unpkg.com/vanilla-breeze/dist/cdn/vanilla-breeze.js"></script>

npm

npm install vanilla-breeze
import 'vanilla-breeze';
import 'vanilla-breeze/css';

Themes

The main bundle includes only the core themes. Decorative themes are standalone token files — add one line and set data-theme:

<link rel="stylesheet" href="https://unpkg.com/vanilla-breeze/dist/cdn/themes/nord.css">
<html data-theme="nord">

Or via npm: import 'vanilla-breeze/themes/nord';. Runtime switching (<theme-picker>, ThemeManager) fetches theme CSS automatically on first use.

Usage

<nav>
  <a href="/">Home</a>
  <a href="/about">About</a>
</nav>

<main data-layout="stack">
  <h1>Hello Vanilla Breeze</h1>
  <p>Semantic HTML, styled automatically.</p>

  <accordion-wc>
    <details>
      <summary>Section One</summary>
      <p>Content here.</p>
    </details>
    <details>
      <summary>Section Two</summary>
      <p>More content.</p>
    </details>
  </accordion-wc>
</main>

No classes needed — elements are styled through cascade layers.

Documentation

Full docs, interactive demos, and examples at profpowell.github.io/vanilla-breeze.

License

MIT

About

A layered HTML component system. Build with native HTML elements, enhance progressively with CSS custom elements and JavaScript web components.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages