@hueycolor/vue

Composable color picker components for Vue
3,849 53
Install
npm install @hueycolor/vue
Latest Version:1.0.1
Vue:3
License:MIT
Last Updated:May 3, 2026
Links: GitHub  ·  npm
Maintainer: eihab_khan

@hueycolor/vue

Composable, customizable color picker components for Vue 3.

Installation

npm install @hueycolor/vue

Usage

Wrap your components in HueyRoot with a v-model bound to a HueyColor value. All child components automatically share the color state.

<script setup lang="ts">
import {
  HueyRoot,
  HueSlider,
  AlphaSlider,
  HexInput,
  SaturationArea,
  ColorPreview,
  hueyColor,
} from '@hueycolor/vue'
import { ref } from 'vue'

const color = ref(hueyColor('#3b82f6'))
</script>

<template>
  <HueyRoot v-model="color">
    <SaturationArea />
    <HueSlider />
    <AlphaSlider />
    <HexInput />
    <ColorPreview />
  </HueyRoot>
</template>

Components

Root

Component Description
HueyRoot Required wrapper. Accepts v-model of type HueyColor.

Sliders

Component Description
SaturationArea 2D saturation/lightness picker canvas
HueSlider Hue range slider
SaturationSlider Saturation range slider
LightnessSlider Lightness range slider
AlphaSlider Alpha/opacity range slider

Inputs

Component Description
HexInput Hex color text input
HueInput Hue number input
SaturationInput Saturation number input
LightnessInput Lightness number input
AlphaInput Alpha number input
RedInput Red channel number input
GreenInput Green channel number input
BlueInput Blue channel number input

Display

Component Description
ColorPreview Swatch showing the current color. Accepts splitPreview prop to show old/new side by side.
ColorSwatch Renders a list of color swatches. Accepts a swatch prop of string[].
ColorDropper Eye dropper button using the browser EyeDropper API.

Accessing color state

Use useHueyContext inside any component rendered within HueyRoot to read or set the current color.

<script setup lang="ts">
import { useHueyContext } from '@hueycolor/vue'

const { hue, saturation, lightness, alpha, colorValue, setColor } = useHueyContext()
</script>
Property Type Description
hue Ref<number> Current hue (0–360)
saturation Ref<number> Current saturation (0–100)
lightness Ref<number> Current lightness (0–100)
alpha Ref<number> Current alpha (0–1)
colorValue Ref<HueyColor> Current color object
setColor (color: string | HueyColor) => void Set the color from any supported format

License

MIT

Related Packages

vue-channel-color-picker

A RGB, CMYK & Graytone color Picker

2,233 0
vue-color-gradient-picker

Color and gradient picker for vue.js

36,015 61
@caohenghu/vue-colorpicker

Colorpicker of Vue Components

92,829 120
@rareformlabs/vue-colorful

A tiny color picker component library for Vue 3 apps. Fast, accessible, dependen...

1,045 1

Version History

Version Released License
1.0.1 MIT
1.0.0 MIT
Pre-releases (6)
Version Released License
0.0.1-beta.9 MIT
0.0.1-beta.8 MIT
0.0.1-beta.6 MIT
0.0.1-beta.5 MIT
0.0.1-beta.4 MIT