Skip to content

pmndrs/leva

Repository files navigation

npm (tag) npm bundle size GitHub Workflow Status Discord Shield


A GUI you are going to lava.
Customizable, extensible and beautiful by default.



🚧🚧 This repo is under heavy development 🚧🚧

Features

  • ⭐️ Beautiful by default
  • 🎚 More than 12 different kinds of inputs available
  • 🧐 Smart input type recognition
  • πŸ”Œ Easy-to-make plugins
  • βœ… Keyboard accessible
  • ⚑️ No setup necessary

Installation

npm i leva

Quick start

Simply call the useControls hook from anywhere in your app:

import { useControls } from 'leva'

function MyComponent() {
  const { name, aNumber } = useControls({ name: 'World', aNumber: 0 })

  return (
    <div>
      Hey {name}, hello! {aNumber}
    </div>
  )
}

NOTE: Using Leva with React 18 will cause a console error about createRoot which you can safely ignore, or fix by following the instructions here: discussion

Documentation

Contributors ✨

Thanks goes to these wonderful people (emoji key):


Andrew Prifer

πŸ€” πŸ’»

Aria

πŸ€”

David Bismut

πŸ€” πŸ’»

Dmitry Ivakhnenko

πŸ’»

Gianmarco

πŸ€” πŸ’»

Guido Vizoso

πŸ’»

Han

🎨

Ivan Rossi

πŸ›

Laurin Quast

πŸ’» πŸ€”

Marco Fugaro

πŸ€”

Marco Ludovico Perego

πŸ€”

Piotr Monwid-Olechnowicz

πŸ“–

clementcassajus

🎨

thephoenixofthevoid

πŸ›

This project follows the all-contributors specification. Contributions of any kind welcome!