<p align="center">
    <img alt="Logo" src="assets/logo.svg" width=100/>
</p>
<h1 align="center" style="border-bottom: none; margin-top: -8px;">@emingy/core</h1>
<h6 align="center">A modern React UI component library with TypeScript support, comprehensive testing, and Storybook documentation.</h6>
<p align="center">
  <a href="https://www.npmjs.com/package/@emingy/configs">
    <img alt="npm version" src="https://img.shields.io/npm/v/@emingy/core?logo=npm">
  </a>
  <a href="https://github.com/semantic-release/semantic-release">
    <img alt="semantic-release" src="https://img.shields.io/badge/semantic--release-angular-e10079?logo=semantic-release">
  </a>
  <a href="LICENSE">
    <img alt="License" src="https://img.shields.io/npm/l/@emingy/core">
  </a>
</p>

---

## ✨ Features

- 🎨 Modern React UI components with TypeScript support
- 📚 Interactive documentation via [Storybook](https://emingy.github.io/core/)
- 🧪 100% test coverage

---

## 📦 Installation

Install the package with peer dependencies:

```bash
npm install @emingy/core react react-dom react-router-dom classnames
# or
yarn add @emingy/core react react-dom react-router-dom classnames
# or
pnpm add @emingy/core react react-dom react-router-dom classnames
```

### Peer Dependencies

- `react` ^19.2.0
- `react-dom` ^19.2.0
- `react-router-dom` ^6.30.3
- `classnames` ^2.5.1

---

## 📚 Documentation

Full component documentation and interactive examples are available at:

**[https://emingy.github.io/core/](https://emingy.github.io/core/)**

---

## 🛠️ Development

### Prerequisites

- Node.js 22
- pnpm 10

### Commands

```bash
# Install dependencies
pnpm install

# Start Storybook
pnpm storybook

# Run tests
pnpm test

# Build library
pnpm build

# Lint & format
pnpm lint:fix
pnpm format:fix
```

---

## 📄 License

ISC © [Emingy](https://github.com/emingy)
