v2.0.0

Mat Design Colors

The complete Material Design color palette for JavaScript & TypeScript. 19 color families, powerful utilities, and CSS generation.

npm install mat-design-colors
🎨

19 Color Families

Complete Material Design palette with all shades from 50 to 900 plus accent colors

🛠️

Color Utilities

Lighten, darken, mix colors, calculate contrast, and more with powerful utility functions

🎯

TypeScript Ready

Full TypeScript support with comprehensive type definitions and JSDoc documentation

CSS Generation

Generate CSS custom properties and utility classes automatically

Color Palette

Click any color to copy its hex code to your clipboard

Color Utilities

Powerful functions for color manipulation and analysis

CSS Generator

Generate ready-to-use CSS for your projects

/* Click "Generate" to create CSS */

Quick Start

Basic Usage

import { MaterialColor, ColorShade } from 'mat-design-colors';

// Access any color
const red500 = MaterialColor.RED[ColorShade.S500];
// "#F44336"

// Accent shades
const pinkA200 = MaterialColor.PINK[ColorShade.SA200];
// "#FF4081"

Color Utilities

import { lighten, darken, alpha, mix } from 'mat-design-colors';

// Lighten a color
const lighter = lighten('#F44336', 20);

// Add transparency
const transparent = alpha('#F44336', 0.5);
// "rgba(244, 67, 54, 0.5)"

// Mix two colors
const mixed = mix('#FF0000', '#0000FF');

Helper Functions

import { 
  getColor, 
  getContrastColor,
  generateCSSVariables 
} from 'mat-design-colors';

// Get color by name
const blue = getColor('BLUE', 'S500');

// Auto contrast text color
const textColor = getContrastColor('#F44336');
// "#FFFFFF"

// Generate CSS variables
const css = generateCSSVariables();
Copied!