r3dy
v1.1.0
Published
<br/> <div align="center"> <a href="www.r3dyui.com"> <img src="https://i.imgur.com/mXk9ke7.jpeg" height="350" align="center" alt="header" /> </a> <br/> <br/>
Downloads
7
Keywords
Readme
R3DY UI is an open source React Library that contains a number of 3D components. With R3DY, you import your 3D components just like any other React component. These components are interactive and can be implemented with little to no knowledge of 3D rendering.
R3DY UI is fully compatible with any React project, including additional frameworks such as NextJS and Remix.
Components
The library comes with 5 prebuilt components which can be modified through a series of properties.
If you'd like to see a new component, head over to The R3DY UI issues page to add your suggestions!
Installation
Use the package manager npm to install R3DY UI.
npm install r3dy
Once you've installed the npm package, its time to add a component to your project. In the code snipped below, you can see how this is implemented.
Usage Example
import { Canvas } from '@react-three/fiber'
import { TextField } from 'r3dy'
# returns 'a react component containing the r3dy element'
export default function myComponent() {
return (
<div>
<Canvas shadows>
<TextField/>
</Canvas>
</div>
)
}
NOTE: You want to make sure that you have imported the necessary dependencies. Import the desired component from r3dy
as well as Canvas
from @react-three/fiber
. Now that you've included dependencies, wrap your component in a Canvas
tag. Make sure to include shadows
in the Canvas
tag or they will not show up.
The div
is meant to contain the Canvas
. By nature, Canvas
will try to fill as much space as allowed. If it is not nested in a div
and you have any sort of margin or padding, it will constantly expand to fit those margins.
Contributing
R3DY UI is an open-source product maintained by OS Labs, an open-source tech accelerator.
We welcome contributions and feedback from the community to make R3DY UI even better. If you're interested in simplifying 3D in your React projects, check out our documentation and join us on this exciting journey!
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Please make sure to update tests as appropriate.
Documentation
Our full documentation can be found here.
Contributing
We value our contributors. Read more about us.