# @kelvininc/ui-components

> Kelvin UI Components

Latest version **3.0.0** (published 2026-07-22) · SEE LICENSE IN LICENSE license · 0 weekly downloads

## Install

```sh
npm install @kelvininc/ui-components
pnpm add @kelvininc/ui-components
yarn add @kelvininc/ui-components
bun add @kelvininc/ui-components
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 3.0.0 |
| Published | 2026-07-22 |
| First published | 2022-02-21 |
| Weekly downloads | 0 |
| License | SEE LICENSE IN LICENSE |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 5 |
| Unpacked size | 7.9 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 31 |
| Author | Kelvin Inc. |
| Maintainers | miguel.pinto, engineering_kelvin, ricardogoncalves89, kv.daniel.carvalho |
| Keywords | kelvin, kelvin ui components |

## Links

- npm: https://www.npmjs.com/package/@kelvininc/ui-components
- Repository: https://github.com/kelvininc/ui-components
- Homepage: https://docs.kelvininc.com
- Issues: https://support.kelvininc.com
- npm.io page: https://npm.io/package/@kelvininc/ui-components

## Dependencies (5)

- [inputmask](https://npm.io/package/inputmask.md) ~5.0.8
- [lodash-es](https://npm.io/package/lodash-es.md) ^4.17.21
- [pluralize](https://npm.io/package/pluralize.md) ^8.0.0
- [@floating-ui/dom](https://npm.io/package/@floating-ui/dom.md) ^1.5.4
- [css-element-queries](https://npm.io/package/css-element-queries.md) ^1.2.3

## Alternatives

- [@progress/kendo-ooxml](https://npm.io/package/@progress/kendo-ooxml.md) — 152.1K weekly downloads
- [@progress/kendo-react-ripple](https://npm.io/package/@progress/kendo-react-ripple.md) — 8.0K weekly downloads
- [@progress/kendo-react-orgchart](https://npm.io/package/@progress/kendo-react-orgchart.md) — 4.3K weekly downloads
- [@praxisui/dynamic-fields](https://npm.io/package/@praxisui/dynamic-fields.md) — 2.4K weekly downloads
- [@mesalvo/react-ui](https://npm.io/package/@mesalvo/react-ui.md) — 1.7K weekly downloads

## Recent versions

- 3.0.0 (latest) — 2026-07-22
- 0.4.1-alpha.38 (canary) — 2022-02-23
- 2.1.0 — 2026-06-26
- 2.0.1 — 2026-05-15
- 2.0.0 — 2026-05-14
- 0.55.0 — 2026-02-05
- 0.54.0 — 2025-11-17
- 0.53.0 — 2025-10-20
- 0.52.0 — 2025-10-20
- 0.51.0 — 2025-10-10
- 0.50.0 — 2025-10-02
- 0.49.0 — 2025-08-06
- 0.48.0 — 2025-07-08
- 0.47.1 — 2025-06-05
- 0.47.0 — 2025-06-05
- … 52 more at https://npm.io/package/@kelvininc/ui-components/versions

## README

# Kelvin UI Components

Kelvin UI Components provides a set of reusable, high quality framework-agnostic UI components, this means you can use with React or if you prefer, the components are also available as W3C compliant WebComponents.

This is not just a library of UI components as it's also a style guide where you can see how the component looks and behaves by interacting with it, to showcase this we use [Storybook](https://storybook.js.org/), a free open-source tool.

Our Storybook is publicly available [here](https://kelvininc.github.io/ui-components/)

## Migration Guide

If you are upgrading to the new design token system, please refer to the [Migration Guide](./MIGRATION.md) for detailed instructions on how to update your application.

## Technological Stack

-   Development: [StencilJS](https://stenciljs.com/docs/introduction)
-   Testing: [Puppeteer](https://pptr.dev/) & [Jest](https://jestjs.io/)

## Getting Started

### Development

To start a Stencil development server, run:

```bash
pnpm start
```

### Production

To build the component for production, run:

```bash
pnpm build
```

To run the tests for the components, run:

```bash
pnpm test # or test:watch to watch for changes
```

## Contributing

### Component naming

When creating new components, always use `kv` as the tag prefix for your component (E.g: `<kv-datepicker>`).

### Merge flow

1. Create a branch using `dev` as your source branch
2. Develop the component and write tests for it
3. Check if your code has any linting issues using `pnpm lint`
4. Run the tests using `pnpm test`
5. Create a pull request pointing to `dev`

---
_Source: https://npm.io/package/@kelvininc/ui-components · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._