> For the complete documentation index, see [llms.txt](https://valence.isaacshea.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://valence.isaacshea.com/overview/readme.md).

# Welcome to Valence

Valence is an opinionated design system and React component library designed by Isaac Shea. It is currently in use in [Threaditor](https://threaditor.net/), and is designed to be completely usable across all platforms.

{% hint style="info" %}
**Valence 4 is here.** It replaces the `variant` prop with a composable [material system](/core-concepts/materials.md), adds a declarative [animation system](/core-concepts/animations.md), and requires React 19. See the [4.0.0 update notes](/update-notes/4.0.0.md) to migrate.
{% endhint %}

## Motivation

This library exists to combat shortcomings I (Isaac Shea) had found with other libraries. I had previously been using Mantine for my projects, however found I was re-constructing several core components *on top* of Mantine, thus eventually decided to start from the bottom with my own design system.

Valence is updated alongside any current projects I work on, and thus follows my own personal design sense quite closely. I attempt to build in as much customizability as possible, however sometimes I am too lazy to add granular control.

## Open source

Valence is open source! It is available [here on GitHub](https://github.com/valence-dev/valence-ui).