Skip to content
TheChatArchiveThe Chat Archive
GPT 5.1· openaiHugging Face Frontier Reasoning Traces

Design a Tailwind CSS plugin to generate custom shadows and gradients.

  1. User

    Design a Tailwind CSS plugin to generate custom shadows and gradients.

  2. Assistant

    Designing a Tailwind CSS Plugin

    The user wants to create a Tailwind CSS plugin for custom shadows and gradients, using Tailwind v3+. I need to interpret "design" both conceptually and in terms of actual implementation. So, I’ll write a functional plugin that configures shadows and gradients from the theme.

    The plugin will read theme values and generate utilities like .shadow-soft and .bg-gradient-brand. I'll need to decide if we should include both box-shadow and gradient utilities, including gradient directions.Defining Custom Shadows and Gradients

    To set up the custom shadows and gradients in Tailwind, I can define them in the tailwind.config under theme.extend. It'll look like this:

    theme: {
      extend: {
        customShadows: {...},
        customGradients: {...}
      }
    }
    

    I need to ensure I use unique names like customShadows to avoid conflicts with existing Tailwind keys like boxShadow.

    Using matchUtilities, I can create a plugin that maps these values to classes like .shadow-custom-soft-lg. However, I must be careful with naming to prevent clashes with core classes.Creating Custom Shadows and Gradients

    I’m thinking about how to add keys for custom shadows like soft-lg to my plugin. The user suggested focusing on a plugin but I'm considering supporting different shadow types, like ring shadows and drop shadows.

    For the gradient part, Tailwind uses the backgroundImage theme, but I want my plugin to generate fluid gradient utilities from the config. So I'll use matchUtilities for this to create classes like .bg-gradient-brand and even for text gradients using similar logic.

    Additionally, I might want to include directional gradients for added flexibility.Outlining a Tailwind CSS Plugin

    I realize that the user wants a bit more than just straightforward gradient utilities—they're looking for a plugin that includes both code and usage examples.

    So, first, I’ll provide standalone plugin code, like plugins/custom-effects.js. Then, I'll need to show how to configure theme.customShadows and theme.customGradients in the example tailwind.config.js.

    I'll include usage documentation that illustrates how to apply classes like shadow-custom-soft-lg bg-gradient-brand. Maybe I can also incorporate advanced features, such as supporting CSS variables for gradients, but I want to ensure it doesn’t get too complicated for the user. Ideally, I’ll also add a variety of gradient types and shadow intensities too.Designing a Tailwind CSS Plugin

    I'm thinking about how to design this plugin for generating custom shadows and gradients based on user input. I can create a structure for customGradients that allows users to define entries as linear gradients, but I want to keep things simple. The plugin will read from these gradient definitions to output CSS styles.

    First, I'll provide a high-level overview before diving into the custom-effects.js plugin code and showing how to integrate it into the tailwind.config.js. I want to include usage examples to help the user apply these classes easily. While adding optional features like supporting CSS variables could complicate things, I’ll ensure the explanations are concise.

    Finally, I can also consider creating a more advanced structure where users can customize defaults through options, but I’ll keep the initial example straightforward.Designing a Tailwind CSS Gradient Plugin

    I'm considering a plugin that allows users to define custom gradients and shadows in Tailwind CSS. The theme could represent colors as brand shades, and gradients could be specified either as color arrays or simple strings.

    I’ll implement a function to handle both object and array forms in the plugin, managing the color resolution from the theme. While thinking about optional parameters adds complexity, I might keep it straightforward, allowing users to write their gradient definitions.

    I'll focus on crafting clean plugin code that integrates well with tailwind.config.js, along with usage examples. Finally, I’ll clarify how to customize gradients while avoiding conflicts with existing utility names.Creating a Custom Tailwind CSS Plugin

    I'm designing a Tailwind CSS plugin for custom shadows and gradients. I'll start by defining a matchUtilities function using a 'shadow-' prefix for clarity. The user should be able to extend theme keys in their tailwind.config.js.

    The plugin will include default shadow and gradient values. I'll structure the final answer to present the plugin concept, provide JavaScript code, and include usage examples. This way, users can customize shadows and gradients easily within their projects! Here’s a complete, ready‑to‑use Tailwind CSS plugin that generates custom shadow and gradient utilities, plus how to wire it up and use it.


    1. Plugin file

    Create plugins/custom-effects.js:

    // plugins/custom-effects.js
    const plugin = require('tailwindcss/plugin');
    
    module.exports = plugin(
      function ({ matchUtilities, theme }) {
        //
        // 1) Custom shadows
        //    -> .shadow-soft-md, .shadow-glass, etc.
        //
        matchUtilities(
          {
            shadow: (value) => ({
              boxShadow: value,
            }),
          },
          {
            values: theme('customShadows'),
          }
        );
    
        //
        // 2) Background gradients
        //    -> .bg-gradient-brand, .bg-gradient-hero, etc.
        //
        matchUtilities(
          {
            'bg-gradient': (value) => ({
              backgroundImage: value,
            }),
          },
          {
            values: theme('customGradients'),
          }
        );
    
        //
        // 3) Text gradients
        //    -> .text-gradient-brand, .text-gradient-hero, etc.
        //
        matchUtilities(
          {
            'text-gradient': (value) => ({
              backgroundImage: value,
              WebkitBackgroundClip: 'text',
              backgroundClip: 'text',
              color: 'transparent',
            }),
          },
          {
            values: theme('customGradients'),
          }
        );
      },
      {
        //
        // Default tokens. These are *extendable* or overridable
        // from your tailwind.config.js
        //
        theme: {
          extend: {
            customShadows: {
              'soft-xs': '0 1px 4px rgba(15, 23, 42, 0.08)',
              'soft-sm': '0 2px 8px rgba(15, 23, 42, 0.10)',
              'soft-md': '0 8px 24px rgba(15, 23, 42, 0.14)',
              'soft-lg': '0 18px 45px rgba(15, 23, 42, 0.18)',
              inner: 'inset 0 0 0 1px rgba(148, 163, 184, 0.35)',
              glass: '0 24px 60px rgba(15, 23, 42, 0.55)',
            },
            customGradients: {
              brand:
                'linear-gradient(135deg, #4f46e5 0%, #ec4899 50%, #f97316 100%)',
              'brand-soft':
                'linear-gradient(135deg, rgba(79,70,229,0.12), rgba(236,72,153,0.12))',
              'radial-sky':
                'radial-gradient(circle at top, #22d3ee 0%, #1d4ed8 60%, #020617 100%)',
              glass:
                'linear-gradient(135deg, rgba(15,23,42,0.90), rgba(15,23,42,0.70))',
            },
          },
        },
      }
    );
    

    What this generates:

    • For each entry in theme.customShadows:
      • shadow-{key} → box-shadow: {value};
    • For each entry in theme.customGradients:
      • bg-gradient-{key} → background-image: {value};
      • text-gradient-{key} → gradient text using background-clip

    2. Tailwind config

    In your tailwind.config.js:

    // tailwind.config.js
    module.exports = {
      content: ['./src/**/*.{js,ts,jsx,tsx,html}'],
      theme: {
        extend: {
          // Optional: add or override plugin defaults
          customShadows: {
            card: '0 18px 40px rgba(15, 23, 42, 0.25)',
          },
          customGradients: {
            hero:
              'linear-gradient(120deg, #0f172a 0%, #1d4ed8 30%, #ec4899 80%)',
          },
        },
      },
      plugins: [
        require('./plugins/custom-effects'),
      ],
    };
    

    You can add as many tokens as you want under:

    • theme.extend.customShadows
    • theme.extend.customGradients

    Each key becomes a class suffix.


    3. Usage examples

    <!-- Custom shadows -->
    <div class="shadow-soft-md bg-white rounded-xl p-6">
      Soft card
    </div>
    
    <div class="shadow-glass bg-slate-900/70 rounded-3xl p-8">
      Glassy panel
    </div>
    
    <!-- Background gradients -->
    <section class="bg-gradient-hero text-white py-20">
      Hero section
    </section>
    
    <button
      class="bg-gradient-brand text-white px-4 py-2 rounded-lg shadow-soft-sm"
    >
      Call to action
    </button>
    
    <!-- Text gradients -->
    <h1 class="text-4xl font-bold text-gradient-brand">
      Gradient headline
    </h1>
    

    Customize by editing or adding tokens in customShadows and customGradients; the plugin will automatically generate the corresponding shadow-*, bg-gradient-*, and text-gradient-* utilities.

Responses were produced in different, uncontrolled contexts (system prompts, settings, prior turns). This is not a benchmark.