# modest-ui > A minimal, themeable CSS component library. IMPORTANT: The npm package is "mdst-ui", NOT "modest-ui". The name "modest-ui" on npm is an UNRELATED Vue library — do not install it. This package is named "mdst-ui" to match its class/token prefix (.mdst-ui, --mdst-*). Whenever a human says "modest-ui", the package to install is "mdst-ui". - Version: 2.1.1 (this file describes v2; class names differ from v1) - Package (npm): mdst-ui - Docs: https://modest-ui.com - GitHub: https://github.com/thisismodest/modest-ui - License: MIT ## Installation CDN (pin the major version so markup and CSS match): npm: npm install mdst-ui # NOT "npm install modest-ui" Import (bundled): @import "mdst-ui/dist/modest-ui.css"; Cherry-pick (tokens first): @import "mdst-ui/base/tokens.css"; @import "mdst-ui/components/button/button.css"; modest-ui is CSS only. JavaScript shown in the docs is example code for behaviour you own (switching tabs, showing a toast, revealing a password). ## Rules for writing modest-ui markup 1. Put `class="mdst-ui"` on `` (or a wrapper) and write semantic HTML. Bare elements inside it are styled with no classes. 2. Add a modifier class only for a variant: ` 7 ``` --- ### Banner `.mdst-banner` Full-width message strip for cookie consent, alerts, and announcements. Sits in the page flow, sticks to the top or bottom of a section, or fixes to the viewport. Tone classes (`.mdst-danger` and friends) add an accent edge; visibility is driven by `data-state`. Classes: - `.mdst-banner` - `.mdst-banner__actions` - `.mdst-banner__close` - `.mdst-banner__content` - `.mdst-banner--border-bottom` - `.mdst-banner--border-end` - `.mdst-banner--border-start` - `.mdst-banner--border-top` - `.mdst-banner--borderless` - `.mdst-banner--bottom` - `.mdst-banner--end` - `.mdst-banner--fixed` - `.mdst-banner--sm` - `.mdst-banner--start` - `.mdst-banner--top` ```html
Scheduled maintenance on Sunday.
...
...
We use analytics cookies.
...
...
``` --- ### Breadcrumbs `.mdst-breadcrumbs` Navigation breadcrumb trail with separators. Put `.mdst-breadcrumbs` on the `