@threlte/rapier/README.md

Components and hooks to use the Rapier physics engine in Threlte

<div align="right">
 <a href="https://www.npmjs.com/package/@threlte/rapier">
  <img alt="npm" src="https://img.shields.io/npm/v/@threlte/rapier?color=fe4100&labelColor=171d27&logo=npm&logoColor=white"/>
 </a>
 <a href="https://github.com/threlte/threlte/blob/main/LICENSE.md">
  <img alt="license" src="https://img.shields.io/npm/l/@threlte/core?color=fe4100&labelColor=171d27&logo=git&logoColor=white"/>
 </a>
 <a href="https://discord.com/channels/985983540804091964">
  <img alt="discord" src="https://img.shields.io/discord/985983540804091964?label=discord&color=fe4100&labelColor=171d27&logo=discord&logoColor=white"/>
 </a>
 <a href="https://threlte.xyz">
  <img alt="docs" src="https://img.shields.io/website?down_color=red&down_message=offline&label=docs&color=fe4100&labelColor=171d27&up_message=online&url=https%3A%2F%2Fthrelte.xyz&logo=svelte&logoColor=white"/>
 </a>
</div>

<a href="https://threlte.xyz">
 <img src="https://threlte.xyz/logo/threlte-banner.jpg"/>
</a>

## Rapidly Build Interactive 3D Apps for the Web

Threlte is a [Svelte](https://svelte.dev/) library that simplifies creating 3D apps for the web. It provides a **declarative**, **type-safe**, **reactive** and **interactive** API out-of-the-box.

Threlte's **3D rendering** is powered by [Three.js](https://threejs.org/), and it also provides a **physics engine** through [Rapier](https://rapier.rs/) and an **animation studio** via [Theatre.js](https://www.theatrejs.com/); see [packages](#packages) for details.

Check out our **[documentation](https://threlte.xyz)** and our **[Discord community](https://discord.gg/EqUBCfCaGm)**.

## @threlte/rapier

[@threlte/rapier](https://threlte.xyz/docs/reference/rapier/getting-started) enables performant physics in your Threlte app through the [Rapier engine](https://rapier.rs/).

This is a great way to implement key features of games or simulators, such as collisions, gravity and attraction fields.

## Quickstart

### Installation

Check out the [installation instructions](https://threlte.xyz/docs/learn/getting-started/installation).

### Support

Have questions? Feel free to ask in our [Discord support forum](https://discord.com/channels/985983540804091964/1031843197963477002).

## Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.

- **Filing Issues** - if you have feature requestions or you think you spotted a bug, [submit an issue](https://github.com/threlte/threlte/issues/new).
- **Contributing Code** - if you would like to drop us a PR, read the [contribution guide](https://github.com/threlte/threlte/blob/main/CONTRIBUTING.md) first.

---

### License

The MIT License (MIT). Please see the [License File](LICENSE.md) for more information.