https://github.com/hannojg/react-native-box2d

JSI port of the Box2D physics engine for React Native.
https://github.com/hannojg/react-native-box2d

physics-2d physics-engine react-native react-native-jsi

Last synced: 4 months ago
JSON representation

JSI port of the Box2D physics engine for React Native.

• Host: GitHub
• URL: https://github.com/hannojg/react-native-box2d
• Owner: hannojg
• License: mit
• Created: 2022-07-17T06:36:55.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2023-03-17T14:23:43.000Z (almost 2 years ago)
• Last Synced: 2024-10-14T10:19:05.971Z (4 months ago)
• Topics: physics-2d, physics-engine, react-native, react-native-jsi
• Language: C++
• Homepage:
• Size: 3.42 MB
• Stars: 61
• Watchers: 3
• Forks: 3
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# react-native-box2d

> ⚠️🚧 This is WIP and not ready for production use. 🚧⚠️

>

> I am still actively developing this library.

JSI port of the [Box2D physics engine](https://box2d.org/) for React Native.

Use real world physics to build gestures, animations, games or anything else you can think of.

![](./docs/img/example-boxes.webp)

---

## Installation

### React Native

```sh

yarn add react-native-box2d

cd ios && pod install

```

## Usage

TODO: Add usage example

## Limitations

As the library uses JSI for synchronous native methods access, remote debugging (e.g. with Chrome) is no longer possible. Instead, you should use [Flipper](https://fbflipper.com).

## Thanks

- [react-native-jsi-library-template](https://github.com/mrousavy/react-native-jsi-library-template)

- [box2d](https://box2d.org/)

- [@shopify/react-native-skia](https://github.com/Shopify/react-native-skia)

## Contributing

See the [contributing guide](CONTRIBUTING.md) to learn how to contribute to the repository and the development workflow.

## License

MIT