> ## Documentation Index
> Fetch the complete documentation index at: https://juo.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting started

> Install and use @juo/customer-ui web components in any framework or plain HTML.

`@juo/customer-ui` provides framework-agnostic web components built on the Shadow DOM. The components integrate with any HTML page or framework — no build step required for the CDN path.

## Installation

<Tabs>
  <Tab title="CDN">
    Add a single script tag to your page. All `<juo-*>` elements become available immediately.

    ```html theme={null}
    <script src="https://cdn.jsdelivr.net/npm/@juo/customer-ui@next/dist/web-components.iife.js"></script>
    ```
  </Tab>

  <Tab title="npm / ESM">
    ```bash theme={null}
    npm install @juo/customer-ui
    ```

    Call `defineCustomElements()` once at your app entry point:

    ```js theme={null}
    import { defineCustomElements } from "@juo/customer-ui/web-components";
    defineCustomElements();
    ```
  </Tab>
</Tabs>

## Theming

Components read design tokens from CSS custom properties on `:root`. Override any token to customize component appearance:

```css theme={null}
:root {
  --theme-accent-600: oklch(52% 0.20 265);
  --theme-radius: 6px;
}
```

See [Design Tokens](/docs/customer-ui/design-tokens) for the full token reference.
