# Ranger

> The primary purpose of Ranger is to offer a flexible, headless range slider component for React applications, enabling developers to build customizable sliders with multiple handles, logarithmic interpolation, custom step sizes, and dynamic updates. It targets use cases such as data visualization, filtering controls, or user input ranges requiring precision and adaptability. The library is designed to be lightweight, performant, and extensible, fitting seamlessly into modern React applications while maintaining compatibility with TypeScript.

**Remember:**
- Headless UI
- Multiple Handles
- Custom Steps/Step-Size
- Logarithmic Interpolation
- Update-on-Drag
- React Ranger (React-specific wrapper)

## Docs
- [Installation](https://github.com/tanstack/ranger/blob/main/docs/installation.md): install & quickstart.
- [Overview](https://github.com/tanstack/ranger/blob/main/docs/overview.md): install & quickstart.
- [Concepts](https://github.com/tanstack/ranger/blob/main/docs/concepts.md): core concept.
- [Faq](https://github.com/tanstack/ranger/blob/main/docs/faq.md): core concept.
- [Quick Start](https://github.com/tanstack/ranger/blob/main/docs/quick-start.md): docs page.
- [React Ranger](https://github.com/tanstack/ranger/blob/main/docs/framework/react/react-ranger.md): docs page.
- [Basic](https://github.com/tanstack/ranger/blob/main/docs/framework/react/api/basic.md): API reference.
- [Custom Steps](https://github.com/tanstack/ranger/blob/main/docs/framework/react/api/custom-steps.md): API reference.
- [Custom Styles](https://github.com/tanstack/ranger/blob/main/docs/framework/react/api/custom-styles.md): API reference.
- [Logarithmic Interpolator](https://github.com/tanstack/ranger/blob/main/docs/framework/react/api/logarithmic-interpolator.md): API reference.

## Tutorials
- [README](https://github.com/tanstack/ranger/blob/main/examples/react/basic/README.md): install & quickstart.
- [README](https://github.com/tanstack/ranger/blob/main/examples/react/custom-steps/README.md): install & quickstart.
- [README](https://github.com/tanstack/ranger/blob/main/examples/react/custom-styles/README.md): install & quickstart.
- [README](https://github.com/tanstack/ranger/blob/main/examples/react/logarithmic-interpolator/README.md): install & quickstart.
- [README](https://github.com/tanstack/ranger/blob/main/examples/react/update-on-drag/README.md): install & quickstart.
- [Basic](https://github.com/tanstack/ranger/blob/main/examples/react/basic/index.html): worked example.
- [Custom Steps](https://github.com/tanstack/ranger/blob/main/examples/react/custom-steps/index.html): worked example.
- [Custom Styles](https://github.com/tanstack/ranger/blob/main/examples/react/custom-styles/index.html): worked example.
- [Logarithmic Interpolator](https://github.com/tanstack/ranger/blob/main/examples/react/logarithmic-interpolator/index.html): worked example.
- [Update On Drag](https://github.com/tanstack/ranger/blob/main/examples/react/update-on-drag/index.html): worked example.

## Optional
- [Contributing](https://github.com/tanstack/ranger/blob/main/CONTRIBUTING.md): docs page.
- [Changelog](https://github.com/tanstack/ranger/blob/main/packages/ranger/CHANGELOG.md): version history.
- [Changelog](https://github.com/tanstack/ranger/blob/main/packages/react-ranger/CHANGELOG.md): version history.
- [README](https://github.com/tanstack/ranger/blob/main/README.md): docs page.
- [Prettier.Config](https://github.com/tanstack/ranger/blob/main/prettier.config.js): docs page.
- [Verify Links](https://github.com/tanstack/ranger/blob/main/scripts/verify-links.ts): docs page.

## Packages
- [README](https://github.com/tanstack/ranger/blob/main/packages/ranger/README.md): install & quickstart.
- [README](https://github.com/tanstack/ranger/blob/main/packages/react-ranger/README.md): install & quickstart.
- [Tsdown.Config](https://github.com/tanstack/ranger/blob/main/packages/ranger/tsdown.config.ts): docs page.
- [Tsdown.Config](https://github.com/tanstack/ranger/blob/main/packages/react-ranger/tsdown.config.ts): docs page.
- [Index](https://github.com/tanstack/ranger/blob/main/packages/ranger/src/index.ts): docs page.
- [Utils](https://github.com/tanstack/ranger/blob/main/packages/ranger/src/utils.ts): docs page.
