Michael Mannucci
Statamic Modifier: Shades
What is it
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.
How to install it
Install via composer or the Control Panel.
composer require michaelmannucci/shadesHow to use it
Shades can be used in two ways: automatically generate Tailwind CSS color palettes, or manually generate tints and/or shades.
Tailwind CSS palette
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 modifier -
tailwindlets the modifier know that you intend to use it to generate a Tailwind CSS palette, instead of generating shades or tints manually -
nameis 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:
1. Put the following in your layout.antlers.html file, right under the <body> tag:
{{ "#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>2. In your tailwind.config.js file, add the following:
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.
Manual generation
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 modifier -
tintorshadelets the modifier know whether you want to make a brighter tint, or a darkers shade -
percentageis 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
