# Lism CSS

> Lism CSS is a lightweight, layout-first CSS framework for rapidly building the structural skeleton of websites. No build step required — just import the CSS. It also provides dedicated React and Astro components via npm.

- GitHub: https://github.com/lism-css/lism-css
- npm: `lism-css` (core CSS + React components; Astro components via `lism-css/astro` subpath), `@lism-css/ui` (UI components)
- License: MIT

## Getting Started

- [Overview](https://lism-css.com/en/docs/overview.md): An overview of Lism CSS and its key features.
- [Installation](https://lism-css.com/en/docs/installation.md): Learn how to install Lism CSS and get started with the basics.
- [Changelog](https://lism-css.com/en/docs/changelog.md): A log of all notable changes and updates across Lism CSS releases.
- [Features of Lism CSS](https://lism-css.com/en/docs/features.md): An in-depth look at the design approach and key features of Lism CSS.
- [MCP Server](https://lism-css.com/en/docs/mcp.md): Set up the MCP server so AI coding tools can reference Lism CSS component, Props, and token information in real time.
- [Skills](https://lism-css.com/en/docs/skills.md): Place a SKILL.md file in your project to communicate Lism CSS design rules, Props, tokens, and naming conventions to AI agents.

## Documentation

- [AutoColumns (l--autoColumns)](https://lism-css.com/en/docs/primitives/l--autoColumns.md): l--autoColumns is a breakpoint-independent multi-column class where columns automatically wrap before shrinking below a specified minimum width.
- [Base Styles](https://lism-css.com/en/docs/base-styles.md): Learn about the Reset CSS and HTML element base styles defined in the lism-base layer.
- [Box (l--box)](https://lism-css.com/en/docs/primitives/l--box.md): l--box is a simple class that groups content without applying any particular layout behavior.
- [BoxLink (is--boxLink)](https://lism-css.com/en/docs/trait-class/is--boxLink.md): is--boxLink is a class that makes an entire box clickable.
- [Center (l--center)](https://lism-css.com/en/docs/primitives/l--center.md): l--center is a class for centering elements both horizontally and vertically.
- [Cluster (l--cluster)](https://lism-css.com/en/docs/primitives/l--cluster.md): l--cluster is a class that arranges multiple elements horizontally and wraps them to the next line when there are too many to fit.
- [Color Tokens](https://lism-css.com/en/docs/tokens/colors.md): A reference of semantic colors and palette color tokens defined in Lism CSS, along with customization examples.
- [Columns (l--columns)](https://lism-css.com/en/docs/primitives/l--columns.md): l--columns is a column class that displays content in the specified number of columns at each breakpoint.
- [Container (is--container)](https://lism-css.com/en/docs/trait-class/is--container.md): is--container is a class that declares container-type to enable container queries.
- [CSS Builds](https://lism-css.com/en/docs/customize/build.md): How to choose which pre-built CSS file to load — toggling @layer on/off, switching to full.css, and using isFullMode.
- [CSS Methodology](https://lism-css.com/en/docs/css-methodology.md): An overview of the CSS layer structure and class design methodology behind Lism CSS.
- [CSS Purge](https://lism-css.com/en/docs/customize/purge.md): Set up the purge plugin to strip unused Lism CSS classes at build time and ship a leaner production CSS.
- [Customize](https://lism-css.com/en/docs/customize.md): An overview of customization options for Lism CSS — choose the right approach based on your goal: switching CSS builds, lism.config.js, SCSS, or CSS Purge.
- [Decorator (a--decorator)](https://lism-css.com/en/docs/primitives/a--decorator.md): a--decorator is a class used as an empty element for decorating content.
- [Design Tokens](https://lism-css.com/en/docs/tokens.md): A reference of all design tokens in Lism CSS, including colors, spacing, and shadows.
- [Divider (a--divider)](https://lism-css.com/en/docs/primitives/a--divider.md): a--divider is a class for rendering a dividing line between content sections.
- [Flex (l--flex)](https://lism-css.com/en/docs/primitives/l--flex.md): l--flex is a class for arranging content using Flexbox.
- [Flow (l--flow)](https://lism-css.com/en/docs/primitives/l--flow.md): l--flow is a flow class that manages spacing between child elements using margin.
- [Frame (l--frame)](https://lism-css.com/en/docs/primitives/l--frame.md): l--frame is a class that fits the direct child media element (img, video, iframe) to its own size.
- [Grid (l--grid)](https://lism-css.com/en/docs/primitives/l--grid.md): l--grid is a class for arranging content using CSS Grid.
- [Group](https://lism-css.com/en/docs/core-components/group.md): A Lism component that outputs a <div> tag.
- [Half-Leading (line-height)](https://lism-css.com/en/docs/tokens/half-leading.md): How Lism CSS manages line-height through half-leading values, and the related design tokens.
- [Heading](https://lism-css.com/en/docs/core-components/heading.md): A Lism component that outputs heading tags (<h1> to <h6>).
- [Icon (a--icon)](https://lism-css.com/en/docs/primitives/a--icon.md): a--icon is a class for displaying icon elements.
- [Inline](https://lism-css.com/en/docs/core-components/inline.md): A Lism component that outputs a <span> tag.
- [Layer (is--layer)](https://lism-css.com/en/docs/trait-class/is--layer.md): is--layer is a class for creating overlay layers absolutely positioned on top of a parent element.
- [Link](https://lism-css.com/en/docs/core-components/link.md): A Lism component that outputs an <a> tag.
- [Lism](https://lism-css.com/en/docs/core-components/lism.md): A general-purpose component that accepts a wide range of props from the Lism CSS design system.
- [Lism Props](https://lism-css.com/en/docs/core-components/lism-props.md): A reference for the Lism CSS-specific props accepted by <Lism>-family components.
- [lism.config.js](https://lism-css.com/en/docs/customize/config.md): How to extend component props, tokens, traits, and breakpoints using lism.config.js and @lism-css/plugin.
- [List & ListItem](https://lism-css.com/en/docs/core-components/list.md): Lism components that output list tags (<ul>, <li>).
- [Media](https://lism-css.com/en/docs/core-components/media.md): A Lism component for outputting media elements such as images and videos.
- [Naming Conventions](https://lism-css.com/en/docs/naming.md): An explanation of the Prop-name and value-name abbreviation rules for Property Classes, along with the naming conventions for CSS variables in Lism CSS.
- [Primitive Class](https://lism-css.com/en/docs/primitives.md): An overview of Lism CSS primitive classes (l--, a--) and their usage.
- [Property Class](https://lism-css.com/en/docs/property-class.md): A complete list of Property Classes that map to CSS properties, with usage examples.
- [Reset CSS](https://lism-css.com/en/docs/reset-css.md): Learn about the lightweight Reset CSS provided by Lism CSS and how to load it.
- [Responsive](https://lism-css.com/en/docs/responsive.md): Learn how Lism CSS handles responsive design with breakpoint classes and variables.
- [SCSS Customization](https://lism-css.com/en/docs/customize/scss.md): How to override lism-css SCSS variables (such as the setting module variables $breakpoints / $props) to adjust generated classes and breakpoints.
- [Set Class](https://lism-css.com/en/docs/set-class.md): Learn about the set-- utility classes for overriding base styles and redefining tokens.
- [Spacer (a--spacer)](https://lism-css.com/en/docs/primitives/a--spacer.md): a--spacer is a class for reserving space between elements.
- [Spacing Tokens](https://lism-css.com/en/docs/tokens/spacing.md): An overview of Fibonacci-based spacing tokens in Lism CSS and which property classes support them.
- [Stack (l--stack)](https://lism-css.com/en/docs/primitives/l--stack.md): l--stack is a class that arranges multiple elements vertically using a Flex layout.
- [SwitchColumns (l--switchColumns)](https://lism-css.com/en/docs/primitives/l--switchColumns.md): l--switchColumns is a class that switches between multi-column and single-column without using container queries or media queries.
- [Text](https://lism-css.com/en/docs/core-components/text.md): A Lism component that outputs a <p> tag.
- [TileGrid (l--tileGrid)](https://lism-css.com/en/docs/primitives/l--tileGrid.md): l--tileGrid is a class for creating uniform tile-style grid layouts by specifying cols and rows.
- [Trait Class](https://lism-css.com/en/docs/trait-class.md): Learn about Trait Classes: is--* for declaring roles and has--* for attaching features.
- [Typography Tokens](https://lism-css.com/en/docs/tokens/typography.md): An overview of typography design tokens in Lism CSS, including font-family, font-size, line-height, and more.
- [Utility Class](https://lism-css.com/en/docs/utility-class.md): Learn about the utility classes in Lism CSS that apply bundled styles and decorations.
- [WithSide (l--withSide)](https://lism-css.com/en/docs/primitives/l--withSide.md): l--withSide is a two-column class that automatically switches between horizontal and vertical arrangements based on the content width you want to preserve.
- [Wrapper (is--wrapper)](https://lism-css.com/en/docs/trait-class/is--wrapper.md): is--wrapper is a class that collectively controls the width of its direct child content.

## UI Components

- [Accordion](https://lism-css.com/en/ui/accordion.md): Documentation for the Accordion component provided by @lism-css/ui.
- [Alert](https://lism-css.com/en/ui/alert.md): Documentation for the Alert component provided by @lism-css/ui.
- [Avatar](https://lism-css.com/en/ui/avatar.md): Documentation for the Avatar component provided by @lism-css/ui.
- [Badge](https://lism-css.com/en/ui/badge.md): Documentation for the Badge component provided by @lism-css/ui.
- [Button](https://lism-css.com/en/ui/button.md): Documentation for the Button component provided by @lism-css/ui.
- [Callout](https://lism-css.com/en/ui/callout.md): Documentation for the Callout component provided by @lism-css/ui.
- [Chat](https://lism-css.com/en/ui/chat.md): Documentation for the Chat component provided by @lism-css/ui.
- [Details](https://lism-css.com/en/ui/details.md): Documentation for the Details component provided by @lism-css/ui.
- [DummyText](https://lism-css.com/en/ui/dummytext.md): A component for outputting dummy text for prototyping and design mockups.
- [Modal](https://lism-css.com/en/ui/modal.md): Documentation for the Modal component provided by @lism-css/ui.
- [NavMenu](https://lism-css.com/en/ui/navmenu.md): Documentation for the NavMenu component provided by @lism-css/ui.
- [ShapeDivider](https://lism-css.com/en/ui/shapedivider.md): Documentation for the ShapeDivider component provided by @lism-css/ui.
- [Tabs](https://lism-css.com/en/ui/tabs.md): Documentation for the Tabs component provided by @lism-css/ui.

## Optional

- [-bd](https://lism-css.com/en/docs/property-class/bd.md): How to use the -bd property classes and related CSS variables for border styling.
- [-hov](https://lism-css.com/en/docs/property-class/hov.md): How to use the -hov property classes for controlling hover behavior and transitions.
- [-max-sz](https://lism-css.com/en/docs/property-class/max-sz.md): How to use the -max-sz class for controlling the maximum width of content.
- [Banner](https://lism-css.com/en/ui/examples/banner.md): Example implementation of banner link patterns using Lism CSS.
- [Breadcrumb](https://lism-css.com/en/ui/examples/breadcrumb.md): Example implementation of breadcrumb navigation using Lism CSS.
- [Card](https://lism-css.com/en/ui/examples/card.md): Example implementation of card-style content layouts using Lism CSS.
- [DividerLabel](https://lism-css.com/en/ui/examples/dividerlabel.md): Example implementation of a labeled divider component using Lism CSS.
- [FAQ](https://lism-css.com/en/ui/examples/faq.md): Example implementation of FAQ (Q&A) layouts using Lism CSS.
- [Hero](https://lism-css.com/en/ui/examples/hero.md): Example implementation of hero content sections using Lism CSS.
- [Reel](https://lism-css.com/en/ui/examples/reel.md): Example implementation of a horizontally scrollable reel component using Lism CSS.
- [Steps](https://lism-css.com/en/ui/examples/steps.md): Example implementation of step-by-step procedural layouts using Lism CSS.