Skip to content
Minimum-Viable-WebPublic

About

A tiny css framework designed for accessibility.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Ministyle

Publish Package

Ultra-minimal, accessible CSS. Classless-first styling with a small set of utility classes. No JS, no build step.

  • ~14 KB min, ~3 KB gzip · 0 dependencies · ~208 lines
  • Dark mode (system + toggle) · Golden-ratio typography · WCAG AAA contrast
  • CSS-only: tabs, toast, tooltips, accordion · Grid, cards, alerts, badges, pagination, breadcrumbs
  • Container queries · Print stylesheet · prefers-reduced-motion / prefers-contrast

Looking for a tiny web ecosystem? See Minimum Viable Web.


Framework Comparison

Feature Ministyle Tailwind Bootstrap Pico Water.css
Classless HTML styling ✅ ❌ ❌ ✅ ✅
Dark mode (auto) ✅ ❌ ❌ ✅ ✅
Dark mode (toggle) ✅ ✅ ❌ ❌ ❌
Golden ratio typography ✅ ❌ ❌ ❌ ❌
CSS-only tabs ✅ ❌ ❌ ❌ ❌
CSS-only toast ✅ ❌ ❌ ❌ ❌
CSS-only tooltips ✅ ❌ ❌ ❌ ❌
CSS-only accordion ✅ ❌ ❌ ❌ ❌
Container queries ✅ ✅ ❌ ❌ ❌
Grid system ✅ ✅ ✅ ❌ ❌
Cards ✅ ❌ ✅ ❌ ❌
Alerts ✅ ❌ ✅ ❌ ❌
Badges ✅ ❌ ✅ ❌ ❌
Pagination ✅ ❌ ✅ ❌ ❌
Breadcrumbs ✅ ❌ ✅ ❌ ❌
Buttons (sizes) ✅ ✅ ✅ ❌ ❌
Form validation states ✅ ❌ ✅ ✅ ❌
Compact inline forms ✅ ✅ ✅ ❌ ❌
Spacing utilities ✅ ✅ ✅ ❌ ❌
Color utilities ✅ ✅ ✅ ❌ ❌
Responsive visibility ✅ ✅ ✅ ❌ ❌
Loading spinner ✅ ❌ ✅ ❌ ❌
Divider with text ✅ ❌ ❌ ❌ ❌
Print stylesheet ✅ ❌ ✅ ❌ ❌
WCAG AAA contrast ✅ ❌ ❌ ❌ ❌
prefers-reduced-motion ✅ ✅ ✅ ✅ ✅
prefers-contrast ✅ ❌ ❌ ❌ ❌
Skip navigation ✅ ❌ ❌ ❌ ❌
Screen reader utility ✅ ✅ ✅ ❌ ❌

Size Comparison

Framework CSS (min) CSS (gzip) Dependencies Classes
Ministyle ~15 KB ~3 KB 0 ~30 utility + classless
Tailwind CSS ~300 KB / ~10 KB purged ~8 KB purged PostCSS, build 14,000+
Bootstrap 5 ~160 KB ~25 KB Optional JS 1,200+
Pico CSS ~50 KB ~10 KB 0 ~10
Water.css ~4 KB ~1.5 KB 0 0 (classless only)

Developer Experience

Aspect Ministyle Tailwind Bootstrap Pico
Learning curve Near zero High Medium Very low
Setup Drop-in <link> Build config Optional Sass Drop-in
Customization 10 CSS variables tailwind.config Sass variables CSS variables
JS for components 0 N/A Optional 0
Best for Content, docs, a11y Custom UIs, design systems Dashboards, enterprise Simple sites

Install

GitHub Packages (npm-compatible). Add a project .npmrc or global config so the scope uses GitHub's registry:

@minimum-viable-web:registry=https://npm.pkg.github.com

Authenticate with a personal access token (read:packages), then:

npm install @minimum-viable-web/ministyle

Link in HTML:

<link rel="stylesheet" href="ministyle.css">

CDN:

<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/Minimum-Viable-Web/ministyle@1.0/ministyle.css">

Copy: Drop ministyle.css into your project (single file, no build).

Usage

Semantic HTML is styled by default. Add classes only for components or layout.

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>My page</title>
  <link rel="stylesheet" href="ministyle.css">
</head>
<body>
  <header>
    <nav aria-label="Main"><strong>Site</strong> <a href="/">Home</a></nav>
  </header>
  <main>
    <h1>Hello</h1>
    <p>Content here.</p>
  </main>
</body>
</html>

Dark mode toggle: Add class="dark-mode" or class="light-mode" on <html>. System preference is used when neither class is set.

Customization

Override CSS custom properties in your own stylesheet or inline:

  • --bg, --text, --link, --border, --card, --ok, --err
  • --r (radius), --mw (max-width), --shadow

Demos

Publishing (maintainers)

Publish to GitHub Packages by pushing a version tag (e.g. v1.0.0) or running the Publish Package workflow manually. Uses GITHUB_TOKEN; no extra secrets.

License

MIT — see LICENSE.

About

A tiny css framework designed for accessibility.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages