phpcolor/primer-colors

Primer Colors - PHP Color Palette

v1.0.0 2026-08-22 08:02 UTC

Requires

• php: >=8.3

Suggests

• phpcolor/phpcolor: Provides ColorPaletteInterface objects through palette().

MIT

• Simon André
• Raphaël Geffroy

• theme
• github
• color
• primer
• scale
• palette

Published on Packagist.org on 2026-08-22 08:27 UTC

README

This package provides access to the color palettes used in Primer CSS.

Installation

composer require phpcolor/primer-colors:^1.0

The package works standalone. Install phpcolor/phpcolor only when using palette():

composer require phpcolor/phpcolor

Usage

Color themes

use PhpColor\Colors\Primer\PrimerColors as Primer;

$colors = Primer::colors();
$colors = Primer::colors('light');

$colors = Primer::colors('dark');

Color names

use PhpColor\Colors\Primer\PrimerColors as Primer;

$colors = Primer::colors();

$names = $colors->getNames(); 
// 'gray', 'blue', 'green', 'yellow', 'orange',
// 'red', 'purple', 'pink', 'coral'

Color shades

use PhpColor\Colors\Primer\PrimerColors as Primer;

$colors = Primer::colors();

$shades = $colors->getShades(); 
// 0, 1, 2, 3, 4, 5, 6, 7, 8, 9

Color values

use PhpColor\Colors\Primer\PrimerColors as Primer;

$colors = Primer::colors();

echo $colors->coral;           // #C4432B
echo $colors->coral();         // #C4432B
echo $colors->coral(5);        // #C4432B

echo $colors->get('coral');    // #C4432B
echo $colors->get('coral', 5); // #C4432B

PHPColor palette

use PhpColor\Color\Palette\ColorPaletteInterface;
use PhpColor\Colors\Primer\PrimerColors as Primer;

$palette = Primer::colors('dark')->palette('coral');
assert($palette instanceof ColorPaletteInterface);

echo $palette->get(5)->toHex(); // #cf462d

Calling palette() without phpcolor/phpcolor installed throws a LogicException with the installation command.

Credits

The colors listed in this project are based on the colors used by Primer.

License

This PHPColor package is released under the MIT license.