decodelabs/spectrum

Bring colour to PHP

v0.3.8 2025-10-03 15:25 UTC

Requires

• php: ^8.4
• decodelabs/coercion: ^0.3.3
• decodelabs/exceptional: ^0.6.1
• decodelabs/nuance: ^0.2

Requires (Dev)

• decodelabs/lucid: ^0.8
• decodelabs/phpstan-decodelabs: ^0.7

Conflicts

• decodelabs/lucid: <0.6

MIT

• Tom Wright

• color
• colour

README

Parse and manipulate colors

Spectrum offers a simple but powerful system for parsing, inspecting, manipulating and exporting colors.

Installation

This package requires PHP 8.4 or higher.

Install via Composer:

composer require decodelabs/spectrum

Usage

Load and manipulate any color with ease through RGB, HSL and HSV formats.

use DecodeLabs\Spectrum\Color;

$color = Color::create('#5AB3CD');
$color = Color::create('darkblue');
$color = Color::create('rgba(25,25,25,0.4)');
$color = Color::random();

$color->toHsl();
$color->lighten(0.3); // 30% lighter
$color->setAlpha(0.5); // 50% opacity
$color->toMidtone(); // Medium saturation and lightness

echo $color; // Converts to appropriate CSS value

$contrastColor = $color->contrastAgainst('pink');
$textColor = $color->getTextContrastColor();

Licensing

Spectrum is licensed under the MIT License. See LICENSE for the full license text.