Skip to content

Releases: MartinRapcan/react-native-color-picker

v1.1.0

17 Feb 01:19

Choose a tag to compare

🎨 v1.1.0 - Alpha Channel & Color Palettes

We're excited to announce the first stable release of @darthrapid/react-native-color-picker!

✨ What's New

Alpha Channel Support

Enable transparency control with the new showAlpha prop. The picker displays an alpha slider with a checkerboard background and outputs 8-digit hex colors (#RRGGBBAA).

<ColorPicker value={color} onChange={setColor} showAlpha />

Color Palettes

The new palettes tab replaces the old recent tab and brings powerful palette support:

  • Built-in Tailwind palette - import and use directly
  • Custom palettes - define your own brand colors
  • Color shades - group colors with their shade variants (100-900)
  • Saved colors section - now lives under the palettes tab
import { ColorPicker, tailwindPalette } from "@darthrapid/react-native-color-picker";

<ColorPicker palettes={[tailwindPalette]} />

Controlled Saved Colors

Full control over saved colors for persistence across sessions:

<ColorPicker
  savedColors={savedColors}
  onSaveColor={(hex) => setSavedColors(prev => [hex, ...prev])}
  onClearSaved={() => setSavedColors([])}
/>

💥 Breaking Changes

  • Tab recent has been renamed to palettes
  • maxRecentColors prop removed (use controlled savedColors instead)
  • modalStyle prop renamed to contentStyle
  • clearRecent() ref method renamed to clearSaved()

📦 New Exports

  • tailwindPalette - ready-to-use Tailwind CSS color palette
  • ColorPalette type - for defining custom palettes

🔧 Migration from 0.x

- tabs={["picker", "values", "recent"]}
+ tabs={["picker", "values", "palettes"]}

- maxRecentColors={16}
+ savedColors={savedColors}
+ onSaveColor={handleSave}

- modalStyle={{ ... }}
+ contentStyle={{ ... }}

v0.1.0

14 Feb 11:06

Choose a tag to compare

🎨 @martinrapcan/react-native-color-picker v0.1.0

Initial release of a lightweight HSB color picker for React Native.

Features

  • HSB color picker — saturation/brightness pad + hue slider, all touch-based with PanResponder
  • Modal mode — renders as a small color swatch, tap to open the full picker in a modal
  • Inline mode — render the picker directly in your layout without a modal
  • Tabs — organized into Picker, Values, and Recent tabs — configurable via tabs prop
  • Manual hex input — type in a hex value directly, with validation
  • RGB & HSB display — live color values shown in the Values tab
  • Recent colors — save colors and quickly reselect them from the Recent tab
  • i18n support — override all UI labels via labels prop
  • Light & dark theme — built-in themes via theme prop
  • Responsive sizing — picker pad and hue strip use onLayout and adapt to parent width
  • Configurable panel widthpanelWidth accepts a number or "100%" for modal mode
  • Disabled state — block all touch input via disabled prop
  • Ref APIgetColor(), setColor(), clearRecent(), open(), close()
  • Customizable swatch — size, border radius, and style via props
  • Pure JS — no native code, works with Expo out of the box

Peer Dependencies

  • react >= 18
  • react-native >= 0.72
  • react-native-svg >= 15