# solace-ui-components

> Component library designed for Solace UI

[![npm version](https://img.shields.io/npm/v/solace-ui-components.svg)](https://www.npmjs.com/package/solace-ui-components)
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
[![TypeScript](https://img.shields.io/badge/TypeScript-4.7-blue?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
[![npm downloads](https://img.shields.io/npm/dm/solace-ui-components)](https://www.npmjs.com/package/solace-ui-components)
[![Bundle Size](https://img.shields.io/bundlephobia/minzip/solace-ui-components)](https://bundlephobia.com/package/solace-ui-components)
[![React](https://img.shields.io/badge/React-18.2+-61DAFB?logo=react&logoColor=white)](https://reactjs.org/)
[![Material-UI](https://img.shields.io/badge/Material--UI-v5-007FFF?logo=mui&logoColor=white)](https://mui.com/)

## 🚀 Features

- **Comprehensive Production-Ready Components** - Extensive React component library built on Material-UI
- **TypeScript First** - Full type definitions and strict type safety
- **Accessible by Default** - WCAG compliant components with automated a11y testing
- **Multi-Theme Support** - Built-in themes for Solace, Boomi, and SAP platforms
- **Enterprise Ready** - Apache 2.0 licensed with comprehensive security scanning

## 🔒 Security & Quality Assurance

This library undergoes **comprehensive automated scanning** on every commit:

- ✅ **FOSSA** - License compliance and vulnerability scanning

- ✅ **SonarQube** - Code quality and security hotspot detection
- ✅ **Chromatic** - Visual regression testing for UI consistency
- ✅ **Automated Testing** - Unit tests with Jest + React Testing Library
- ✅ **Pre-commit Validation** - ESLint, TypeScript, and Prettier checks

## 📦 Browser Support

ES5-compatible builds ensure broad browser support across modern evergreen browsers and legacy environments.

## Installation

No special configuration is needed. The public package is named `solace-ui-components`:

```bash
npm install --save solace-ui-components
```

## Usage

```tsx
import React from "react";

import { SolaceButton } from "solace-ui-components";

export default function Example() {
	return <SolaceButton />;
}
```

## License

This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.

Copyright 2023-2025 Solace Systems
