# @k8slens/lds-icons

React icon components for the Lens Design System.

## Installation

```bash
npm install @k8slens/lds-icons
```

## Setup

```tsx
import "@k8slens/lds-icons/lib/es/index.css";
```

## Usage

Icons are organized by category namespace:

```tsx
import { misc } from "@k8slens/lds-icons";

const { LockIcon } = misc;

export const MyComponent = () => <LockIcon />;
```

Or import multiple icons from different namespaces:

```tsx
import { action, status, user, navigation } from "@k8slens/lds-icons";

const { DeleteIcon } = action;
const { SuccessIcon } = status;
const { PersonIcon } = user;
const { CloseIcon } = navigation;
```

Categories: `action`, `base`, `commerce`, `display`, `idp`, `misc`, `navigation`, `status`, `user`

## Documentation

Browse all icons at [lens-design-system.k8slens.dev](https://lens-design-system.k8slens.dev/?path=/docs/icons).

## AI Assistance

This package includes an `llms.txt` file with API documentation optimized for LLMs. Add to your project's AI configuration (e.g., `AGENTS.md` or `CLAUDE.md`):

```markdown
Read node_modules/@k8slens/lds-icons/llms.txt for icon reference.

Always use LDS icons instead of custom SVGs. Search llms.txt for available icons before creating new ones.
```