# kintone-ui-component

> kintone UI Component

Latest version **1.26.0** (published 2026-08-07) · MIT license · 0 weekly downloads

## Install

```sh
npm install kintone-ui-component
pnpm add kintone-ui-component
yarn add kintone-ui-component
bun add kintone-ui-component
```

## 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 | 1.26.0 |
| Published | 2026-08-07 |
| First published | 2018-05-16 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=24.18.0 |
| Dependencies | 3 |
| Unpacked size | 1.6 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 68 |
| Author | Cybozu, Inc. |
| Maintainers | dong0, mikei, nmanhit, h000780 |
| Keywords | kintone, kintone-ui-component, ui framework, ui component |

## Links

- npm: https://www.npmjs.com/package/kintone-ui-component
- Repository: https://github.com/kintone-labs/kintone-ui-component
- Homepage: https://github.com/kintone-labs/kintone-ui-component#readme
- Issues: https://github.com/kintone-labs/kintone-ui-component/issues
- npm.io page: https://npm.io/package/kintone-ui-component

## Dependencies (3)

- [lit](https://npm.io/package/lit.md) ^3.3.3
- [uuid](https://npm.io/package/uuid.md) ^14.0.1
- [core-js](https://npm.io/package/core-js.md) ^3.49.0

## Recent versions

- 1.26.0 (latest) — 2026-08-07
- 1.25.0 — 2026-05-11
- 1.24.0 — 2026-02-06
- 1.23.1 — 2025-11-11
- 1.23.0 — 2025-10-28
- 1.22.0 — 2025-08-12
- 1.21.0 — 2025-06-03
- 1.20.1 — 2025-04-07
- 1.20.0 — 2025-03-28
- 1.19.0 — 2025-01-21
- 1.18.0 — 2024-10-15
- 1.17.1 — 2024-06-04
- 1.17.0 — 2024-03-18
- 1.16.0 — 2024-02-02
- 1.15.0 — 2023-12-15
- … 29 more at https://npm.io/package/kintone-ui-component/versions

## README

[![npm version][npm-image]][npm-url]

<p align="center">
  <img src="./images/logo.png" alt="kuc-logo" align="center" height="100" style="margin: 30px; 0;">
</p>

---

<p align="center">
kintone UI Component is UI Component for kintone customization.<br />
It supports you to develop kintone customization and kintone plugin.<br />
<strong>The document page is <a href="https://ui-component.kintone.dev" rel="noopener" target="_blank">here. </a></strong>
</p>

<p align="center">
  English | <a href="./README-JP.md">日本語</a>
</p>

- [Installation](#installation)
  - [Use with downloading kuc.min.js file](#use-with-downloading-kucminjs-file)
  - [npm](#npm)
  - [CDN](#cdn)
  
- [Usage](#usage)
- [Browser Support](#browser-support)
- [v0 Usage](#v0-usage)
- [Migration Guide](#migration-guide)
- [Contributing Guideline](#contributing-guideline)
- [Roadmap](#roadmap)
- [License](#license)

## Installation
Kintone UI Component is available as the downloaded `kuc.min.js` file, a npm package, or a CDN.

### Use with downloading kuc.min.js file
Please use `kuc.min.js` downloaded from [releases page](https://github.com/kintone-labs/kintone-ui-component/releases).
```
./umd/kuc.min.js
```
### npm
Please install and use `kintone-ui-component` with npm.
```bash
npm install kintone-ui-component
```

> **Note**: You can also use other package managers:
> ```bash
> # pnpm
> pnpm add kintone-ui-component
>
> # yarn
> yarn add kintone-ui-component
> ```

### CDN
Please use these CDN link.

- If you want to specify the version and load it (specify the version number after the project name):
  ```
  https://unpkg.com/kintone-ui-component@1.0.0/umd/kuc.min.js
  ```

- If you want to load the latest version of kintone UI Component:
  ```
  https://unpkg.com/kintone-ui-component/umd/kuc.min.js
  ```

> unpkg is not a CDN service provided by Cybozu. It is recommended that you use this for verification.<br/>
> In the production environment, you can [download the `kuc.min.js` file](#use-with-downloading-kucminjs-file) from GitHub and use it to avoid any failures and problems related to unpkg.

## Usage

```javascript
// UMD
const Kuc = Kucs["1.x.x"];

const text = new Kuc.Text({
  value: "this is text!"
});
```

```javascript
// ES modules
import { Text } from "kintone-ui-component/lib/text";

const text = new Text({
  value: "this is text!"
});
text.addEventListener("change", event => {
  console.log(`text value is changed to ${event.detail.value}`);
});
```

> When using a version on and after v1.4.0, please use `Kucs["1.x.x"]` instead of Kuc and specify your expected version (ex. `new Kucs["1.4.0"].Button()`).<br>
> The rendered components' tags and class names will include the version number.<br>
> You may still use `Kuc` as a global variable but **note that it may be conflicting when adding two or more `kuc.min.js` files** on Kintone customization or plug-in. In this case, the `Kuc` object refers to the last loaded `kuc.min.js` file.<br>
> In case that there is only one `kuc.min.js` file in the Kintone system or there is no problem with using last loaded `kuc.min.js` file, you can use Kuc object. Please remove `const Kuc = Kucs['1.x.x'];` line.
> When using a version before v1.4.0, please use `Kuc` as a global variable but **note that it may be conflicting when adding two or more `kuc.min.js` files** on Kintone customization or plug-in.<br>
> Please visit [Quick Start](https://ui-component.kintone.dev/docs/getting-started/quick-start#installation) and [Version conflicts issue and solution](https://ui-component.kintone.dev/docs/guides/version-conflicts-issue-solution) for more information!

## Browser Support

<table>
  <tr>
    <th>Chrome</th>
    <th>Safari</th>
    <th>Firefox</th>
    <th>Edge</th>
  </tr>
  <tr>
    <td>○</td>
    <td>○</td>
    <td>○</td>
    <td>○</td>
  </tr>
</table>

> We confirmed the operation with the latest version of each compatible browser.

## v0 Usage
:warning::warning: The maintenance of kintone UI Component v0 ended on 31 December 2023. We recommend migrating to [kintone UI Component v1](https://github.com/kintone-labs/kintone-ui-component). :warning::warning:

## Migration Guide
There are differences in specifications and interfaces between v0 and v1.<br />
Please be sure to verify enough when you updating.<br />
For more details, please refer to the articles below.
- [The difference of the way to code between v0 and v1](https://ui-component.kintone.dev/docs/guides/comparison-v0-v1)
- [v1.0.0 Release Notes](https://ui-component.kintone.dev/docs/releases/release-notes-v1.0.0)

> About the React version provided in v0, we haven't supported it in v1 now.

## Contributing Guideline
We welcome contributions to kintone UI Component.<br>
For the details, please check [Contributing Guideline](https://github.com/kintone-labs/kintone-ui-component/blob/master/CONTRIBUTING.md).<br>

If you have a question or feature request, please register [GitHub issue](https://github.com/kintone-labs/kintone-ui-component/issues).<br>
About questions, you can also utilize the following community spaces. These communities are made up of volunteers.<br>
- [kintone developer forum (English site)](https://forum.kintone.dev/c/general/1)
- [cybozu developer community (Japanese site)](https://community.cybozu.dev/c/kintone/5)

And we use [Discussions feature of GitHub](https://github.com/kintone-labs/kintone-ui-component/discussions) as our community page dedicated to this tool.<br>

## Roadmap
We published our development roadmap.<br>
For more details, please refer to [here](https://github.com/kintone-labs/kintone-ui-component/discussions/987).

## License
[MIT LICENSE](./LICENSE)

[npm-image]: https://img.shields.io/npm/v/kintone-ui-component.svg
[npm-url]: https://npmjs.org/package/kintone-ui-component

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