<p align="center">
  <a href="https://github.com/sponsors/niekes"><img src="https://img.shields.io/badge/Sponsor_d3--3d-EA4AAA?logo=githubsponsors&logoColor=white&style=for-the-badge" alt="Sponsor d3-3d"></a>
</p>

<p align="center">
  <strong>3D visualizations for the web, built on <a href="https://d3js.org/">d3.js</a>.</strong><br>
  Free and open source, kept alive by one maintainer and the people who sponsor the work.
</p>

<p align="center">
  <a href="https://github.com/niekes/d3-3d/actions"><img src="https://github.com/niekes/d3-3d/workflows/main/badge.svg" alt="Build"></a>
  <a href="https://github.com/niekes/d3-3d/actions"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/niekes/d3-3d/master/.github/badges/coverage.json" alt="Coverage"></a>
  <a href="https://fallow.tools/docs/explanations/health/"><img src="https://raw.githubusercontent.com/niekes/d3-3d/master/.github/badges/health.svg" alt="fallow health"></a>
  <a href="https://www.npmjs.com/package/d3-3d"><img src="https://img.shields.io/npm/dt/d3-3d" alt="npm downloads"></a>
  <a href="https://www.npmjs.com/package/d3-3d"><img src="https://img.shields.io/npm/dw/d3-3d" alt="npm weekly downloads"></a>
  <a href="https://github.com/Niekes/d3-3d/blob/master/LICENSE"><img src="https://img.shields.io/npm/l/d3-3d" alt="License"></a>
  <a href="https://www.npmjs.com/package/d3-3d"><img src="https://img.shields.io/npm/v/d3-3d" alt="npm version"></a>
  <img src="https://img.shields.io/badge/TypeScript-Ready-blue" alt="TypeScript">
  <a href="https://github.com/niekes/d3-3d"><img src="https://img.shields.io/github/stars/niekes/d3-3d" alt="GitHub stars"></a>
  <a href="https://github.com/sponsors/niekes"><img src="https://img.shields.io/github/sponsors/niekes?logo=GitHub+Sponsors&logoColor=%23EA4AAA&style=flat" alt="GitHub Sponsors"></a>
</p>

<p align="center">
  <a href="https://niekes.github.io/d3-3d/">Docs</a> ·
  <a href="https://niekes.github.io/d3-3d/guide/getting-started">Getting started</a> ·
  <a href="https://niekes.github.io/d3-3d/api/">API reference</a> ·
  <a href="https://niekes.github.io/d3-3d/examples/">Examples</a> ·
  <a href="https://niekes.github.io/d3-3d/guide/migration">Migrating from v0.x</a>
</p>

---

<table>
    <tr style="background-color: #f6f8fa">
        <td><a target="_blank" href="https://niekes.github.io/d3-3d/examples/space-time-cube"><img src="assets/examples/space-time-cube.gif" alt="Space-time cube"></a></td>
        <td><a target="_blank" href="https://niekes.github.io/d3-3d/examples/area-chart"><img src="assets/examples/area-chart.gif" alt="Area chart"></a></td>
        <td><a target="_blank" href="https://niekes.github.io/d3-3d/examples/mini-city"><img src="assets/examples/mini-city.gif" alt="Mini city"></a></td>
    </tr>
    <tr style="background-color: #f6f8fa">
        <td><a target="_blank" href="https://niekes.github.io/d3-3d/examples/particle-text-morph"><img src="assets/examples/particle-text-morph.gif" alt="Particle text morph"></a></td>
        <td><a target="_blank" href="https://niekes.github.io/d3-3d/examples/mesh-inspector"><img src="assets/examples/mesh-inspector.gif" alt="Mesh inspector"></a></td>
        <td><a target="_blank" href="https://niekes.github.io/d3-3d/examples/perspective-street"><img src="assets/examples/perspective-street.gif" alt="Perspective street"></a></td>
    </tr>
</table>

More in the [example gallery](https://niekes.github.io/d3-3d/examples/).

## Sponsor d3-3d

**d3-3d** is free, and it always will be. There is no company behind it — just one maintainer working in spare time — so the cost of keeping it alive is paid for by the people who depend on it.

If d3-3d saves you time, [become a sponsor](https://github.com/sponsors/niekes).

| Tier        | What you get                                                                                |
| ----------- | ------------------------------------------------------------------------------------------- |
| **$5/mo**   | Your name in the [sponsors list](#sponsors) and my sincere thanks                           |
| **$25/mo**  | The above, plus your logo in the README and on the docs site, and priority issue triage     |
| **$100/mo** | The above, plus direct email access for feature requests and a mention in the release notes |

Where the money goes:

- **Issue triage and bug fixes.** Sponsorship buys a reply within a couple of days instead of whenever I get to it.
- **Types that stay correct.** Keeping `index.d.ts` accurate as d3, TypeScript and the DOM move on.
- **The documentation site.** Hosting, builds and the example gallery.
- **Time for new work.** More shapes, better performance, and eventually a WebGL renderer.

Prefer a one-off? The [sponsor page](https://github.com/sponsors/niekes) also takes one-time contributions.

**Need a company sponsorship or an invoice?** [Get in touch](mailto:s@niekes.com).

## Sponsors

Thank you to the people who make this possible. Sponsors at $25/mo and above get their logo in this README and on the docs site; everyone gets their name below.

<!-- New sponsors go below this line, one per line. -->

## Using d3-3d

```bash
npm install d3-3d
```

Everything else lives in the [documentation](https://niekes.github.io/d3-3d/): [getting started](https://niekes.github.io/d3-3d/guide/getting-started), the [API reference](https://niekes.github.io/d3-3d/api/), the [examples](https://niekes.github.io/d3-3d/examples/) and [migrating from v0.x](https://niekes.github.io/d3-3d/guide/migration).

## Star History

[![Star History Chart](https://api.star-history.com/svg?repos=niekes/d3-3d&type=date&legend=bottom-right)](https://www.star-history.com/#niekes/d3-3d&type=date&legend=bottom-right)
