What is a Tailwind color scale and why does it use 50 to 950?
A Tailwind color scale is a set of 11 stops labeled 50, 100, 200, 300, 400, 500, 600, 700, 800, 900, and 950, where 50 is the lightest tint and 950 is the darkest shade. The 500 stop is usually the brand or base color. This naming convention, popularized by Tailwind CSS, gives developers a predictable system for picking the right shade for backgrounds, borders, text, and hover states.
How do I integrate a generated scale into my Tailwind config?
Most generators output a JavaScript snippet you can paste into the theme.extend.colors section of tailwind.config.js. After adding the colors, you can use classes like bg-brand-100, text-brand-700, or border-brand-300 throughout your codebase. Restart your build process so Tailwind picks up the new theme. Once added, the entire scale is available to your team and stays consistent across the application.
Why does my generated 500 stop not match my exact brand color?
Some generators anchor your input as the base and adjust other stops around it, while others slot your color into the closest stop based on lightness. If matching exactly matters, look for a generator that pins your input to 500 explicitly. You can also manually overwrite any stop in the output. Slight perceptual adjustments to the base are sometimes intentional to keep the scale visually balanced.
Should every shade in my scale meet WCAG contrast requirements?
Not every shade needs to pass against every other shade, but you should know which pairings meet WCAG AA. Typically, 50 to 200 work as backgrounds, 600 to 900 work as text, and pairings like 50 background with 700 text comfortably exceed 4.5:1. Test each pairing you actually use in your interface, and avoid mid-range pairings like 400 on 500, which usually fail contrast checks.
Can I generate scales for multiple brand colors and use them together?
Yes, design systems commonly include scales for primary, secondary, neutral, success, warning, and danger colors. Generate each scale separately, then add them all to your Tailwind theme under distinct names. This gives you a consistent vocabulary like primary-500, success-100, or danger-700 across the app. Make sure neutrals are truly desaturated grays, since slightly tinted neutrals can clash with multiple accent scales.
Does Tailwind v4 change how color scales work?
Tailwind v4 moves color configuration into CSS using @theme directives, but the 50 to 950 scale convention remains the same. Instead of editing tailwind.config.js, you define colors as CSS custom properties. Generated scales still apply, you just paste them as --color-brand-100 through --color-brand-950 inside the theme block. The class names you use in HTML are unchanged, so existing code keeps working.