tailwindcss-backgrounds
npx skills add https://github.com/fusengine/agents --skill tailwindcss-backgrounds
Agent 安装分布
Skill 文档
Tailwind CSS Backgrounds Skill
Complete reference for background utilities in Tailwind CSS v4.1, including colors, gradients, images, positioning, sizing, and blend modes.
Background Colors
Use bg-{color} utilities to set background colors with the modernized OKLCH color palette.
<!-- Basic colors -->
<div class="bg-red-500"></div>
<div class="bg-blue-600"></div>
<div class="bg-emerald-400"></div>
<!-- Opacity modifiers -->
<div class="bg-blue-500/50"></div>
<div class="bg-slate-900/75"></div>
Color Palette (OKLCH P3)
The default Tailwind palette uses OKLCH color space for perceptually uniform colors across the wider P3 gamut:
- Neutrals: slate, gray, zinc, neutral, stone
- Colors: red, orange, amber, yellow, lime, green, emerald, teal, cyan, sky, blue, indigo, violet, purple, fuchsia, pink, rose
Each color has 11 shades: 50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 950
Linear Gradients
Create linear gradients using bg-linear-* utilities with direction and color stops.
<!-- Directions -->
<div class="bg-linear-to-t from-blue-500 to-purple-500"></div>
<div class="bg-linear-to-r from-green-400 via-blue-500 to-purple-600"></div>
<div class="bg-linear-to-br from-yellow-200 to-red-600"></div>
<!-- Available directions -->
<!-- bg-linear-to-t, to-tr, to-r, to-br, to-b, to-bl, to-l, to-tl -->
<!-- Custom angles -->
<div class="bg-linear-45 from-slate-400 to-slate-600"></div>
<div class="bg-linear-180 from-indigo-500 to-pink-500"></div>
Direction Utilities
bg-linear-to-t– to topbg-linear-to-tr– to top rightbg-linear-to-r– to rightbg-linear-to-br– to bottom rightbg-linear-to-b– to bottombg-linear-to-bl– to bottom leftbg-linear-to-l– to leftbg-linear-to-tl– to top leftbg-linear-<angle>– custom angle (e.g.,bg-linear-45)
Radial Gradients
Create radial gradients using bg-radial-* utilities.
<div class="bg-radial from-yellow-400 to-slate-900"></div>
<div class="bg-radial from-purple-200 via-blue-400 to-slate-950"></div>
Conic Gradients (NEW in v4.1)
Create conic gradients using bg-conic-* utilities, perfect for color wheels and circular patterns.
<div class="bg-conic-0 from-red-500 to-red-500"></div>
<div class="bg-conic-45 from-blue-400 via-purple-500 to-pink-400"></div>
<div class="bg-conic-[from_45deg] from-slate-400 to-slate-600"></div>
Gradient Color Stops
Control gradient color stops with from-*, via-*, and to-* utilities.
<!-- Two colors -->
<div class="bg-linear-to-r from-blue-500 to-purple-500"></div>
<!-- Three colors -->
<div class="bg-linear-to-r from-green-400 via-blue-500 to-purple-600"></div>
<!-- Custom positions -->
<div class="bg-linear-to-r from-blue-500 from-0% to-purple-500 to-100%"></div>
Background Images
Use bg-[url(...)] to apply custom background images.
<div class="bg-[url(/img/mountains.jpg)]"></div>
<div class="bg-[url(data:image/svg+xml,...)]"></div>
Background Size
Control how background images are sized.
<!-- Predefined sizes -->
<div class="bg-cover"><!-- Fills container, may crop --></div>
<div class="bg-contain"><!-- Scales to fit, may show blank space --></div>
<!-- Custom sizes -->
<div class="bg-[size:10rem]"></div>
<div class="bg-[size:50%]"></div>
<div class="bg-[size:200px_100px]"></div>
Background Position
Position the background image within its container.
<!-- Predefined positions -->
<div class="bg-top-left"></div>
<div class="bg-top"></div>
<div class="bg-top-right"></div>
<div class="bg-left"></div>
<div class="bg-center"></div>
<div class="bg-right"></div>
<div class="bg-bottom-left"></div>
<div class="bg-bottom"></div>
<div class="bg-bottom-right"></div>
<!-- Custom positions -->
<div class="bg-[position:25%_75%]"></div>
Background Repeat
Control how background images repeat.
<!-- Repeat -->
<div class="bg-repeat"><!-- Tile in both directions --></div>
<div class="bg-repeat-x"><!-- Tile horizontally --></div>
<div class="bg-repeat-y"><!-- Tile vertically --></div>
<!-- No repeat -->
<div class="bg-no-repeat"><!-- Single image --></div>
Background Blend Modes
Combine background colors with images using blend modes.
<div class="bg-blue-500 bg-[url(...)] bg-blend-multiply"></div>
<div class="bg-slate-700 bg-[url(...)] bg-blend-overlay"></div>
<div class="bg-amber-400 bg-[url(...)] bg-blend-soft-light"></div>
<!-- Available blend modes -->
<!-- multiply, screen, overlay, darken, lighten, color-dodge,
color-burn, hard-light, soft-light, difference, exclusion,
hue, saturation, color, luminosity -->
Complete Examples
Color Background with Opacity
<div class="bg-slate-900/50 px-6 py-8 rounded-lg">
Content with translucent background
</div>
Gradient Overlay on Image
<div class="bg-[url(/img/hero.jpg)] bg-cover bg-center
bg-linear-to-br from-black/40 to-transparent
h-96 flex items-center justify-center">
<h1 class="text-white text-4xl font-bold">Hero Title</h1>
</div>
Gradient with Multiple Stops
<div class="bg-linear-to-r
from-emerald-500 from-0%
via-blue-500 via-50%
to-purple-600 to-100%
h-20 rounded-lg"></div>
Conic Gradient (Color Wheel)
<div class="w-32 h-32 rounded-full
bg-conic-0
from-red-500 via-yellow-500 via-green-500 via-blue-500 via-purple-500 to-red-500"></div>
Image with Blend Mode
<div class="w-full h-80
bg-blue-600
bg-[url(/img/pattern.png)] bg-cover bg-center
bg-blend-multiply
rounded-lg"></div>
Customization
Extend background utilities in your Tailwind config:
/** @type {import('tailwindcss').Config} */
export default {
theme: {
extend: {
colors: {
brand: {
50: 'oklch(0.971 0.013 17.38)',
500: 'oklch(0.637 0.237 25.331)',
950: 'oklch(0.258 0.092 26.042)',
},
},
backgroundImage: {
gradient: 'url(\'/img/gradient.png\')',
},
},
},
}
Performance Tips
- Use color utilities instead of hex values for better optimization
- Combine with
bg-no-repeatand sizing to prevent unwanted repetition - Layer gradients using multiple background utilities for complex effects
- Use opacity modifiers (
/50) instead of rgba for better tree-shaking - Prefer conic/radial gradients over images when possible for smaller file sizes