Skip to content

domchristie/tailwind-initial

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

tailwind-initial

Generates utilities at a low specificity using CSS layers, letting developers set default styles for a component that can be overridden by adding plain Tailwind utility classes.

Usage

npm install tailwind-initial
// tailwind.config.js
module.exports = {
  theme: {
    // ...
  },
  plugins: [
    require('tailwind-initial'),
    // ...
  ],
}
<h1 class="initial:text-white">Hello, world!</h1><!-- white text -->
<h1 class="initial:text-white text-black">Hello, world!</h1><!-- black text -->

Options

By default, the variant name is initial, and the generated layer name is tw-initial. These names can be customized like so:

// tailwind.config.js
module.exports = {
  theme: {
    // ...
  },
  plugins: [
    require('tailwind-initial')({ name: 'init', layer: 'init-layer' }),
    // ...
  ],
}

Should you use it?

Maybe, maybe not! This is an experimental approach, and it might be preferable to configure your utility classes within your components. However, this might come in handy during the initial stages of component design, when the customization requirements are not yet known.

About

Tailwind plugin that generates utilities at a low specificity

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published