Course contentsShow
← React
Lesson 1939 of 2,39644. Styling ApproachesFree lesson

Composition with sprinkles

Building utility-class systems with @vanilla-extract/sprinkles for Tailwind-like atomic CSS patterns.

Composition with sprinkles

You'll learn how to build a Tailwind-like utility class system using @vanilla-extract/sprinkles for atomic, type-safe styling.

What Are Sprinkles?

Sprinkles is a utility layer on top of vanilla-extract that generates atomic CSS classes similar to Tailwind. Think of it as creating your own custom utility-class system with full TypeScript support. Instead of writing className="bg-blue-500 p-4 rounded", you'll write className={sprinkles({ background: 'blue500', padding: 'medium', borderRadius: 'small' })} — but with complete autocomplete and type checking.

How It Works

You define a defineProperties configuration that maps design tokens to CSS properties. Sprinkles generates a function that accepts these properties and returns optimized class names:

import { defineProperties, createSprinkles } from '@vanilla-extract/sprinkles';

const space = {
  none: '0',
  small: '8px',
  medium: '16px',
  large: '32px',
};

const colors = {
  blue500: '#3b82f6',
  gray100: '#f3f4f6',
};

const properties = defineProperties({
  properties: {
    padding: space,
    margin: space,
    background: colors,
    color: colors,
  },
});

export const sprinkles = createSprinkles(properties);

Now you apply it:

<div className={sprinkles({ padding: 'medium', background: 'blue500' })}>
  Typed utilities!
</div>

Sprinkles generates only the classes you actually use, keeping bundle size minimal. You get Tailwind's ergonomics with vanilla-extract's zero-runtime performance and type safety.

Key Takeaway: Sprinkles bridges utility-first CSS and zero-runtime type safety, letting you build custom atomic class systems that feel like Tailwind but compile away at build time.