---
title: Installation
description: Install LoamUI in any React framework.
---

> LoamUI documentation, generated from the same source as the live page —
> treat it as authoritative for `@loamui/core`.

# Installation

LoamUI works in any React 19 setup. There's no provider and no build plugin: just a package and a stylesheet.

## 1. Install the package

```bash
pnpm add @loamui/core
```

## 2. Import the styles

Import the token stylesheet **once** at the root of your app. It defines the `--loam-*` design
tokens and the base layer that every component builds on.

```tsx
// Next.js App Router: app/layout.tsx

export function SignIn() {
  return (
  );
}
```

## Framework notes

### Next.js

LoamUI components are React Server Component friendly. Interactive components mark themselves
`"use client"` as needed, so you can drop them anywhere.

### Vite

Import `@loamui/core/styles.css` in your `main.tsx` entry. No plugin required; the styles are
plain CSS.

> LoamUI ships static CSS with cascade layers. If you use your own ` @layer` order, the LoamUI layers are named `loamui.tokens`, `loamui.elements` and `loamui.components`.