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.