ui-style-kit-css
v1.2.2
Published
CSS theme and UI style preset library for accessible websites, dashboards, admin interfaces, and client-facing pages.
Maintainers
Readme
UI Style Kit CSS
UI Style Kit CSS is a CSS-only theme and UI style preset library for accessible websites, dashboards, admin interfaces, and customer-facing pages.
It is separate from, but complementary to, Interactive Surface CSS. Use UI Style Kit CSS for visual identity, color themes, UI presets, layout mood, and native HTML styling. Use Interactive Surface CSS for interaction-state animation systems and surface behavior.
Features
- 11 UI style systems
- 10 shared color schemes
light,dark, andcontrastmodes- Combined CSS bundle and optional per-style imports
- Scoped native HTML element coverage
- Visible
:focus-visibledefaults - Skip-link and visually-hidden helpers per style prefix
- Optional bridge tokens for
interactive-surface-css - Reduced-motion, high-contrast, forced-colors, and print support
- Cascade-layered CSS for easier consumer overrides
- No runtime dependencies
Install
npm install ui-style-kit-cssImport
Full bundle:
import "ui-style-kit-css/dist/ui-style-kit.css";Single style system:
import "ui-style-kit-css/styles/minimal-saas.css";
import "ui-style-kit-css/styles/cyberpunk.css";Shortcut imports are also exported:
import "ui-style-kit-css/minimal-saas.css";
import "ui-style-kit-css/retro-glass.css";Optional bridge for Interactive Surface CSS:
import "ui-style-kit-css/interactive-surface-bridge";CDN usage
After publishing to NPM:
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/ui-style-kit-css@latest/dist/ui-style-kit.min.css" />For production, pin a version:
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/[email protected]/dist/ui-style-kit.min.css" />Basic usage
<body data-ui="minimal-saas" data-theme="arctic-indigo" data-mode="light">
<main class="saas-page">
<section class="saas-container saas-stack">
<article class="saas-card">
<h1 class="saas-title">UI Style Kit CSS</h1>
<p class="saas-subtitle">Switch UI systems, themes, and modes with attributes.</p>
<button class="saas-button saas-button-primary">Primary Action</button>
</article>
</section>
</main>
</body>Dynamic switching
document.body.dataset.ui = "cyberpunk";
document.body.dataset.theme = "midnight-gold";
document.body.dataset.mode = "dark";UI systems
| UI style | data-ui | Class prefix | Best for |
|---|---:|---:|---|
| Minimal SaaS | minimal-saas | saas | dashboards, admin tools, SaaS apps |
| Bento UI | bento | bento | landing pages, feature sections, showcases |
| Maximalist / Playful | maximalist | max | creators, entertainment, bold client sites |
| Bauhaus / Swiss Modern | bauhaus | bau | agencies, editorial layouts, design-forward brands |
| Skeuomorphic / Tactile | tactile | tactile | premium tactile interfaces, control panels |
| Neumorphism | neumorphism | neo | soft dashboards, experimental UI |
| Retrofuturism | retrofuturism | retro | futuristic portfolios and product pages |
| Brutalism | brutalism | brutal | bold creative websites |
| Cyberpunk | cyberpunk | cyber | security, gaming, encryption, tech demos |
| Y2K | y2k | y2k | nostalgic, playful, fashion/music/event sites |
| Retro Glass | retro-glass | rg | futuristic glass dashboards and hero sections |
Color themes
midnight-gold
ocean-steel
forest-moss
sunset-ember
royal-plum
graphite-cyan
desert-sage
rose-quartz
cyber-lime
arctic-indigoModes
light
dark
contrastNative HTML coverage
Each style system scopes defaults under [data-ui="..."] and covers common native elements, including:
- headings, paragraphs, links, lists, blockquotes, code, pre, mark, abbr
- images, media, figures, captions
- forms, fieldsets, labels, inputs, textareas, selects, checkboxes, radios, range, color, file inputs
- buttons and submit/reset controls
- tables and captions
details,summary,dialog,progress, andmeter
CSS improves accessibility presentation, but it cannot guarantee accessibility by itself. Use semantic HTML, real labels, keyboard-safe JavaScript, meaningful link/button text, and correct ARIA state management.
Cascade layers
The library styles are wrapped in @layer ui-style-kit.*. Unlayered consumer CSS can override the library without specificity fights:
[data-ui="minimal-saas"][data-theme="arctic-indigo"] {
--saas-primary-rgb: 72 91 255;
}File structure
ui-style-kit-css/
package.json
README.md
LICENSE
CHANGELOG.md
STYLE-MAP.md
dist/
ui-style-kit.css
ui-style-kit.min.css
styles/
minimal-saas.css
bento.css
maximalist.css
bauhaus.css
tactile.css
neumorphism.css
retrofuturism.css
brutalism.css
cyberpunk.css
y2k.css
retro-glass.css
interactive-surface-bridge.css
docs/
TOKENS.md
STYLE-GUIDE.md
PUBLISHING.md
demo/
index.htmlDevelopment checks
npm run check
npm run pack:dry-runnpm run check rebuilds the bundle, runs stylelint, verifies package metadata, and checks core contrast pairs. Optional Playwright visual smoke tests are available through npm run test:visual after installing dev dependencies.
License
MIT
