Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.spotzee.com/llms.txt

Use this file to discover all available pages before exploring further.

A synthetic colour data generator creates sample values for RGB, HSL, HWB, CMYK, LAB, LCH, CSS colour-space and human-readable colour fields. It helps developers, designers and QA teams test design systems, form inputs, visualisation tools and sample datasets without copying production brand tokens.
Generate sample colour data at spotzee.com/tools/color-generator.

​
Why this matters

Colour fields appear in token tables, swatches, previews, import files, chart legends, theme builders and CSS parsers. A fixture set that only contains one hex value can miss formatting, wrapping, parsing and display problems. Generated colour data gives you varied channel, CSS and perceptual colour values for tests. And a numeric seed lets you reproduce the same output after a failure without freezing the fixture set by hand. Generated colour values are test fixture data only. They are not accessibility-checked, brand-approved or production palette recommendations. Each Extended API call deducts a small per-call amount from your Spotzee credit balance. See the Spotzee pricing page for live per-tool pricing.

​
How it works

1

Send the request

POST to /generic/data/generate/color with count. The count is a string from 1 to 100.
2

Choose a method

Use method=profile for expanded colour records, or choose one field method: rgb, hsl, hwb, cmyk, lab, lch, colorByCSSColorSpace, cssSupportedFunction, cssSupportedSpace, human or space.
3

Set method options

Send format, includeAlpha, casing, prefix and cssColorSpace when the selected method supports those controls.
4

Set repeatability

Send locale where supported and an optional numeric seed when the same colour data generator output needs to repeat in tests.
5

Read the response

The response returns data.colors[], generated, locale, optional seed, and the resolved method.

​
Method reference

MethodOutputMain parameters
profileExpanded colour recordcount, locale, seed, format, includeAlpha, casing, prefix, cssColorSpace
rgbRGB colour valuecount, locale, seed, format, includeAlpha, casing, prefix
hslHSL colour valuecount, locale, seed, format, includeAlpha
hwbHWB colour valuecount, locale, seed, format
cmykCMYK colour valuecount, locale, seed, format
labLAB colour valuecount, locale, seed, format
lchLCH colour valuecount, locale, seed, format
colorByCSSColorSpaceCSS colour-space valuecount, locale, seed, format, cssColorSpace
cssSupportedFunctionCSS-supported colour functioncount, locale, seed, format
cssSupportedSpaceCSS-supported colour spacecount, locale, seed, format
humanHuman-readable colour namecount, locale, seed, format
spaceColour-space namecount, locale, seed, format
Use profile when you need many colour fields together. Use a field method when your form, parser or import job only expects one value type.

​
What to watch for

  • Count outside 1 to 100. One request generates up to 100 colour records. For more rows, call the endpoint again and vary the seed when you need a different batch.
  • Hex format on the wrong method. Use format=hex only with rgb or profile. Other methods should use css, decimal or binary.
  • Alpha on unsupported fields. includeAlpha is supported only by rgb, hsl and profile.
  • Prefix on unsupported fields. prefix is supported only by rgb and profile, and can contain up to four letters, numbers or # characters.
  • Wrong CSS colour space. Send cssColorSpace only with colorByCSSColorSpace or profile.
  • Assuming brand suitability. Generated values are synthetic sample data. Do not treat them as approved palette choices or accessibility-reviewed colours.

​
FAQs

A colour data generator can return colors[] records with method and value fields. Profile output can also include RGB, CMYK, CSS colour-space, HSL, HWB, LAB, LCH, human-readable colour and colour-space fields.
Yes. Use method=rgb when a form, parser or import column only needs RGB sample values. You can also set format, includeAlpha, casing and prefix for RGB output.
Yes. Use method=rgb or method=profile, then set format=hex. Hex output supports casing and prefix controls when your test needs those exact shapes.
Yes. Set a numeric seed to reproduce output for the same count, locale, method and option values. Leave the seed blank when you want a fresh random batch for exploratory QA.
Yes. Use method=colorByCSSColorSpace, then set cssColorSpace to sRGB, display-p3, rec2020, a98-rgb or prophoto-rgb. Use profile when a fixture also needs RGB, CMYK, HSL, HWB, LAB and LCH fields.
Read the colour data generator guide for endpoint options, response fields and integration patterns. The guide also shows where colour fixture data fits beside developer fixture, commerce, company and git generators.

​
Try it

Generate sample colour data in the browser at spotzee.com/tools/color-generator, or call the Extended API when you need colour fixtures inside automated tests, design-system checks and seed scripts.