# naive-ui

> A Vue 3 Component Library. Fairly Complete, Theme Customizable, Uses TypeScript, Fast

Latest version **2.45.3** (published 2026-08-27) · MIT license · 0 weekly downloads

## Install

```sh
npm install naive-ui
pnpm add naive-ui
yarn add naive-ui
bun add naive-ui
```

## Health

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

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

Warnings: low downloads; large bundle.

## Facts

| | |
|---|---|
| Version | 2.45.3 |
| Published | 2026-08-27 |
| First published | 2020-02-25 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=20 |
| Dependencies | 18 |
| Unpacked size | 49.5 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 18558 |
| Author | 07akioni |
| Maintainers | 07akioni |
| Keywords | naive-ui, component library, ui framework, ui, vue |

## Links

- npm: https://www.npmjs.com/package/naive-ui
- Repository: https://github.com/tusen-ai/naive-ui
- Homepage: https://www.naiveui.com
- npm.io page: https://npm.io/package/naive-ui

## Dependencies (18)

- [evtd](https://npm.io/package/evtd.md) ^0.2.4
- [vdirs](https://npm.io/package/vdirs.md) ^0.1.8
- [vooks](https://npm.io/package/vooks.md) ^0.2.12
- [vueuc](https://npm.io/package/vueuc.md) ^0.4.66
- [lodash](https://npm.io/package/lodash.md) ^4.17.21
- [seemly](https://npm.io/package/seemly.md) ^0.3.10
- [csstype](https://npm.io/package/csstype.md) ^3.1.3
- [date-fns](https://npm.io/package/date-fns.md) ^4.1.0
- [treemate](https://npm.io/package/treemate.md) ^0.3.11
- [lodash-es](https://npm.io/package/lodash-es.md) ^4.17.21
- [css-render](https://npm.io/package/css-render.md) ^0.15.14
- [date-fns-tz](https://npm.io/package/date-fns-tz.md) ^3.2.0
- [highlight.js](https://npm.io/package/highlight.js.md) ^11.8.0
- [@types/lodash](https://npm.io/package/@types/lodash.md) ^4.17.20
- [async-validator](https://npm.io/package/async-validator.md) ^4.2.5
- [@types/lodash-es](https://npm.io/package/@types/lodash-es.md) ^4.17.12
- [@css-render/vue3-ssr](https://npm.io/package/@css-render/vue3-ssr.md) ^0.15.14
- [@css-render/plugin-bem](https://npm.io/package/@css-render/plugin-bem.md) ^0.15.14

## Alternatives

- [@sindresorhus/slugify](https://npm.io/package/@sindresorhus/slugify.md) — 3.7M weekly downloads
- [solid-js](https://npm.io/package/solid-js.md) — 2.7M weekly downloads
- [expo-glass-effect](https://npm.io/package/expo-glass-effect.md) — 2.5M weekly downloads
- [nanoassert](https://npm.io/package/nanoassert.md) — 780.8K weekly downloads
- [@ffmpeg/ffmpeg](https://npm.io/package/@ffmpeg/ffmpeg.md) — 529.5K weekly downloads

## Recent versions

- 2.45.3 (latest) — 2026-08-27
- 2.32.2-beta.0 (beta) — 2022-08-07
- 2.45.2 — 2026-08-21
- 2.45.1 — 2026-08-19
- 2.45.0 — 2026-08-16
- 2.44.1 — 2026-03-08
- 2.44.0 — 2026-03-08
- 2.43.2 — 2025-11-16
- 2.43.1 — 2025-09-14
- 2.43.0 — 2025-09-13
- 2.42.0 — 2025-06-16
- 2.41.1 — 2025-06-08
- 2.41.0 — 2025-01-05
- 2.40.4 — 2024-12-20
- 2.40.3 — 2024-12-01
- … 144 more at https://npm.io/package/naive-ui/versions

## README

<p align="center">
  <img width="144px" src="https://naiveui.oss-cn-hongkong.aliyuncs.com/naivelogo.svg" />
</p>

<h1 align="center">Naive UI</h1>
<p align="center">A Vue 3 Component Library</p>
<p align="center"><b>Fairly Complete, Theme Customizable, Uses TypeScript, Fast</b></p>
<p align="center">Kinda Interesting</p>

<p align="center">
  <a href="https://npmjs.com/package/naive-ui">
    <img src="https://img.shields.io/npm/v/naive-ui.svg" alt="npm">
  </a>
  <a href="https://pkg.pr.new/~/tusen-ai/naive-ui">
    <img src="https://pkg.pr.new/badge/tusen-ai/naive-ui" alt="pkg.pr.new">
  </a>
</p>

<p align="center">English | <a href="README.zh-CN.md">中文</a></p>

## Documentation

[www.naiveui.com](http://www.naiveui.com)

## Community

- [Discord](https://discord.gg/Pqv7Mev5Dd)
- DingTalk Group 1 (Member limit reached) 33482509
- DingTalk Group 2 (Member limit reached) 35886835
- DingTalk Group 3 (Member limit reached) 32377370
- DingTalk Group 4 (Member limit reached) 8165002788
- DingTalk Group 5 (Member limit reached) 31205022250
- DingTalk Group 6 (Member limit reached) 62720001971
- DingTalk Group 7 172000005810

- [Awesome Naive UI](https://github.com/naive-ui/awesome-naive)

## Features

### Fairly Complete

There are more than 90 components. Hope they can help you write less code.

What's more, they are all treeshakable.

### Theme Customizable

We provide an advanced type safe theme system built using TypeScript. All you need is to provide a theme overrides object in JS. Then all the stuff will be done by us.

What's more, no less/sass/css variables, no webpack loaders are required.

### Uses TypeScript

All the stuff in Naive UI is written in TypeScript. It can work with your typescript project seamlessly.

What's more, you don't need to import any CSS to use the components.

### Fast

I try to make it not rather slow. All data components works with virtual list by default.

What's more, ..., no more. Just enjoy it.

## Installation

### npm

Use npm to install.

```bash
npm i naive-ui
```

### Fonts

```bash
npm i vfonts
```

### Icons

Naive UI recommends using [xicons](https://www.xicons.org) as icon library.

### Design Resources

[Naive UI (Sketch)](https://naive-ui.oss-accelerate.aliyuncs.com/NaiveUI-Design-Library-en-US.sketch).

## Contributing

Please see [CONTRIBUTING.md](https://github.com/tusen-ai/naive-ui/blob/main/CONTRIBUTING.md).

## License

Naive UI is licensed under the [MIT license](https://opensource.org/licenses/MIT).

Graphics resources of `result` component is licensed under the [CC-BY 4.0](https://creativecommons.org/licenses/by/4.0/). The graphics resources come from [Twemoji](https://github.com/twitter/twemoji).

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