A modifier that generates color shades from a given hex color. It can be used with the color fieldtype or with manual input. It can be used generate Tailwind CSS color palettes or to manually generate individual shades and tints.
Install via composer or the Control Panel.
composer require michaelmannucci/shadesShades can be used in two ways: automatically generate Tailwind CSS color palettes, or manually generate tints and/or shades.
You can also automatically generate 10 Tailwind CSS shades and tints to use with Tailwind CSS (eg. bg-yourcolor-500, text-yourcolor-200, etc.). This works by utilizing CSS :root and connecting it to your tailwind.config.js file.
The formula is:
{{ color | shades:tailwind:name }}
colorwould be the color you want to modify. You can use a color fieldtype, or enter one manually (eg.#ff269e.)shadesis the name of the modifiertailwindlets the modifier know that you intend to use it to generate a Tailwind CSS palette, instead of generating shades or tints manuallynameis what you want the custom Tailwind palette to be named (eg.brand,magenta, etc.) so that it can be used in your templates (eg.text-brand-500,bg-magenta-200, etc.)
For example, if you wanted to use a Statamic pink palette named statamic in your templates, you would:
{{ "#ff269e" | shades:tailwind:statamic }}
This will generate the following output:
<style>:root{--statamic-50:#ffe9f5;--statamic-100:#ffd4ec;--statamic-200:#ffa8d8;--statamic-300:#ff7dc5;--statamic-400:#ff51b1;--statamic-500:#ff269e;--statamic-600:#cc1e7e;--statamic-700:#99175f;--statamic-800:#660f3f;--statamic-900:#330820;}</style>
module.exports = {
theme: {
extend: {
colors: {
'statamic': {
50: 'var(--statamic-50)',
100: 'var(--statamic-100)',
200: 'var(--statamic-200)',
300: 'var(--statamic-300)',
400: 'var(--statamic-400)',
500: 'var(--statamic-500)',
600: 'var(--statamic-600)',
700: 'var(--statamic-700)',
800: 'var(--statamic-800)',
900: 'var(--statamic-900)',
},
}
},
},
}
You can now use this color palette in all Tailwind CSS color utilities (eg. border-statamic-400, bg-statamic-900, etc.).
Note: By default, the original color (in this case #ff269e) would be statamic-500.
The formula for manual generation of a tint or shade is:
{{ color | shades:(tint or shade):percentage }}
colorwould be the color you want to modify. You can use a color fieldtype, or enter one manually (eg.#01d0aa.)shadesis the name of the modifiertintorshadelets the modifier know whether you want to make a brighter tint, or a darkers shadepercentageis the degree to which you want to modify the original color
For example, if you wanted to generate a 50% brighter tint of the Statamic green color, you would do:
{{ "#01d0aa" | shades:tint:50 }}
This would return #80e8d5.
Or, if you wanted to generate a 20% darker variant of the Statamic green color, you would do:
{{ "#01d0aa" | shades:shade:20 }}
This would return #01a688