# three

> JavaScript 3D library

Latest version **0.186.0** (published 2026-09-08) · MIT license · 0 weekly downloads

## Install

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

## Health

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

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

Warnings: low downloads; large bundle; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.186.0 |
| Published | 2026-09-08 |
| First published | 2012-12-07 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | separate (@types/three) |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 19.5 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 115790 |
| Author | mrdoob |
| Maintainers | mrdoob, mugen87 |
| Keywords | three, three.js, javascript, 3d, virtual-reality, augmented-reality, webgl, webgl2, webaudio, webgpu, webxr, canvas, svg, html5 |

## Links

- npm: https://www.npmjs.com/package/three
- Repository: https://github.com/mrdoob/three.js
- Homepage: https://threejs.org/
- Issues: https://github.com/mrdoob/three.js/issues
- npm.io page: https://npm.io/package/three

## Alternatives

- [@tsparticles/shape-image](https://npm.io/package/@tsparticles/shape-image.md) — 303.7K weekly downloads
- [@tsparticles/shape-line](https://npm.io/package/@tsparticles/shape-line.md) — 233.7K weekly downloads
- [stringify-attributes](https://npm.io/package/stringify-attributes.md) — 58.6K weekly downloads
- [mobile-drag-drop](https://npm.io/package/mobile-drag-drop.md) — 46.3K weekly downloads
- [@comunica/actor-rdf-parse-html](https://npm.io/package/@comunica/actor-rdf-parse-html.md) — 29.2K weekly downloads

## Recent versions

- 0.186.0 (latest) — 2026-09-08
- 0.185.1 — 2026-07-01
- 0.185.0 — 2026-06-25
- 0.184.0 — 2026-04-16
- 0.183.2 — 2026-02-28
- 0.183.1 — 2026-02-20
- 0.183.0 — 2026-02-18
- 0.182.0 — 2025-12-10
- 0.181.2 — 2025-11-19
- 0.181.1 — 2025-11-10
- 0.181.0 — 2025-10-31
- 0.180.0 — 2025-09-03
- 0.179.1 — 2025-08-02
- 0.179.0 — 2025-08-01
- 0.178.0 — 2025-06-30
- … 298 more at https://npm.io/package/three/versions

## README

# three.js

[![NPM Package][npm]][npm-url]
[![Build Size][build-size]][build-size-url]
[![NPM Downloads][npm-downloads]][npmtrends-url]
[![jsDelivr Downloads][jsdelivr-downloads]][jsdelivr-url]
[![Discord][discord]][discord-url]

#### JavaScript 3D library

The aim of the project is to create an easy-to-use, lightweight, cross-browser, general-purpose 3D library. The current builds only include WebGL and WebGPU renderers but SVG and CSS3D renderers are also available as addons.

[Examples](https://threejs.org/examples/) —
[Docs](https://threejs.org/docs/) —
[Manual](https://threejs.org/manual/) —
[Wiki](https://github.com/mrdoob/three.js/wiki) —
[Migrating](https://github.com/mrdoob/three.js/wiki/Migration-Guide) —
[Questions](https://stackoverflow.com/questions/tagged/three.js) —
[Forum](https://discourse.threejs.org/) —
[Discord](https://discord.gg/56GBJwAnUS)

### Usage

This code creates a scene, a camera, and a geometric cube, and it adds the cube to the scene. It then creates a `WebGL` renderer for the scene and camera, and it adds that viewport to the `document.body` element. Finally, it animates the cube within the scene for the camera.

```javascript
import * as THREE from 'three';

const width = window.innerWidth, height = window.innerHeight;

// init

const camera = new THREE.PerspectiveCamera( 70, width / height, 0.01, 10 );
camera.position.z = 1;

const scene = new THREE.Scene();

const geometry = new THREE.BoxGeometry( 0.2, 0.2, 0.2 );
const material = new THREE.MeshNormalMaterial();

const mesh = new THREE.Mesh( geometry, material );
scene.add( mesh );

const renderer = new THREE.WebGLRenderer( { antialias: true } );
renderer.setSize( width, height );
renderer.setAnimationLoop( animate );
document.body.appendChild( renderer.domElement );

// animation

function animate( time ) {

	mesh.rotation.x = time / 2000;
	mesh.rotation.y = time / 1000;

	renderer.render( scene, camera );

}
```

If everything goes well, you should see [this](https://jsfiddle.net/w43x5Lgh/).

### Cloning this repository

Cloning the repo with all its history results in a ~2 GB download. If you don't need the whole history you can use the `depth` parameter to significantly reduce download size.

```sh
git clone --depth=1 https://github.com/mrdoob/three.js.git
```

### Change log

[Releases](https://github.com/mrdoob/three.js/releases)


[npm]: https://img.shields.io/npm/v/three
[npm-url]: https://www.npmjs.com/package/three
[build-size]: https://badgen.net/bundlephobia/minzip/three
[build-size-url]: https://bundlephobia.com/result?p=three
[npm-downloads]: https://img.shields.io/npm/dw/three
[npmtrends-url]: https://www.npmtrends.com/three
[jsdelivr-downloads]: https://data.jsdelivr.com/v1/package/npm/three/badge?style=rounded
[jsdelivr-url]: https://www.jsdelivr.com/package/npm/three
[discord]: https://img.shields.io/discord/685241246557667386
[discord-url]: https://discord.gg/56GBJwAnUS

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