# uil

> JavaScript gui library

Latest version **5.0.0** (published 2026-11-19) · MIT license · 0 weekly downloads

## Install

```sh
npm install uil
pnpm add uil
yarn add uil
bun add uil
```

## Health

**Score 60/100 (C)** — status: active.

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

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 5.0.0 |
| Published | 2026-11-19 |
| First published | 2017-01-17 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 850.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 585 |
| Author | lo-th |
| Maintainers | lo-th |
| Keywords | uil, uil.js, ui |

## Links

- npm: https://www.npmjs.com/package/uil
- Repository: https://github.com/lo-th/uil
- Homepage: http://lo-th.github.io/uil/
- Issues: https://github.com/lo-th/uil/issues
- npm.io page: https://npm.io/package/uil

## 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

- 5.0.0 (latest) — 2026-11-19
- 4.4.2 — 2025-05-11
- 4.4.1 — 2025-05-11
- 4.4.0 — 2025-02-18
- 4.3.0 — 2023-06-10
- 4.2.9 — 2023-03-25
- 4.2.8 — 2023-02-18
- 4.2.7 — 2022-09-28
- 4.2.6 — 2022-05-17
- 4.2.5 — 2022-05-16
- 4.2.3 — 2022-05-09
- 4.2.2 — 2022-05-06
- 4.2.1 — 2022-05-04
- 4.2.0 — 2022-04-30
- 4.1.0 — 2022-01-27
- … 12 more at https://npm.io/package/uil/versions

## README

[![NPM Package][npm]][npm-url]
[![Build Size][build-size]][build-size-url]
[![NPM Downloads][npm-downloads]][npmtrends-url]

<p align="center"><a href="http://lo-th.github.io/uil/"><img src="http://lo-th.github.io/uil/examples/assets/uil.jpg"/></a></p>

uil.js is a lightweight ui for javascript with a complete 3d display support.<br>
totally customizable, only 6 events, auto resize<br>
[**MAIN EXAMPLE**](http://lo-th.github.io/uil/index.html)

**1 - init engine**
```sh
var ui = new UIL.Gui( { w:300 } )
```
**2 - add value**
```sh
ui.add('title', { name:'Title'})
ui.add('bool', { name:'Bool' })
ui.add('color', { name:'Color', type:'rgba', value:[0,1,1,1]})
ui.add('slide', { name:'Slide', value:50})
let myList = ui.add('list', { name:'List', list:['i1', 'i2', ...]})
```
**3 - add value with object reference**
```sh
const obj = {
  name:'welcome to uil',
  value: 2,
  slider: 30,
  vector: { x:10, y:-30 }
}

ui.add( obj, 'string', { type:'string' })
ui.add( obj, 'value', { type:'number', min:0, max:10, precision:2, step:0.01 })
ui.add( obj, 'slider', { type:'slide' })
ui.add( obj, 'vector', { type:'number' })
```
**4 - callback return the value**
```sh
ui.add('number', { name:'Vector4', value:[0,0,0,0] }).onChange( function(v){ debug.innerHTML = v; } )
```
**5 - you can reset all value**
```sh
ui.clear();
```
**6 - other examples**

[**uil module**](http://lo-th.github.io/uil/examples/index_module.html)

[**uil listen**](http://lo-th.github.io/uil/examples/uil_listen.html)

[**uil color**](http://lo-th.github.io/uil/examples/uil_color.html)

[**uil stresstest**](http://lo-th.github.io/uil/examples/uil_stresstest.html)

[**uil group**](http://lo-th.github.io/uil/examples/uil_group.html)

[**uil to canvas**](http://lo-th.github.io/uil/examples/uil_to_canvas.html)

[**uil to three**](http://lo-th.github.io/uil/examples/uil_3d.html)

[**uil to three 2**](http://lo-th.github.io/uil/examples/uil_3d_2.html)

**7 - uil is on npm**
```sh
npm i uil
```

**8 - creator Tools**

[**uil icon creator**](http://lo-th.github.io/uil/examples/uil_icon.html)

[**uil ARM creator**](http://lo-th.github.io/uil/examples/uil_mapARM.html)

[**uil KTX2 creator**](http://lo-th.github.io/uil/examples/uil_ktx2.html)


[npm]: https://img.shields.io/npm/v/uil
[npm-url]: https://www.npmjs.com/package/uil
[build-size]: https://badgen.net/bundlephobia/minzip/uil
[build-size-url]: https://bundlephobia.com/result?p=uil
[npm-downloads]: https://img.shields.io/npm/dw/uil
[npmtrends-url]: https://www.npmtrends.com/uil

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