Skip to content
View as Markdown

Introduction

LoamUI is a React component library that trusts the platform: native elements carry the semantics, plain CSS carries the styling, and every component ships with axe and keyboard tests.

Why LoamUI?

Most component libraries ship a styling engine to your users' browsers. LoamUI doesn't. Every component is styled with plain CSS (cascade layers, custom properties, light-dark(), color-mix(), container queries and logical properties), so there's nothing to run at runtime and nothing extra to download.

  • Zero-runtime. Styles are static CSS. No CSS-in-JS, no serialization cost, fully compatible with React Server Components.
  • Themeable with variables. Rebrand the whole library by overriding --loam-* tokens. No provider required.
  • Native dark mode. Powered by CSS light-dark(): one toggle flips color-scheme.
  • Accessible by default. Semantic HTML, focus management, and keyboard support baked in.
  • 33 components across inputs, data display, feedback, disclosures and navigation, and expanding.

Installation

Add the package and import the stylesheet once at your app root:

pnpm add @loamui/core
// app/layout.tsximport "@loamui/core/styles.css";import { Button } from "@loamui/core";
export default function Page() {  return <Button>Get started</Button>;}

That's the whole setup. No provider, no config. See the installation guide for framework specifics, or jump into the tokens.

Next steps

  • Installation: framework guides for Next.js, Vite and more.
  • Tokens: the token surface, and the theming that falls out of it.
  • Browse components: live examples and props for every component.