antd_color
Ant Design v6 color system for Flutter — fast color manipulation, palette generation, and CSS color parsing, precisely ported from @ant-design/fast-color v3.
Features
- AntFastColor — Create colors from hex / rgb / hsl / hsv strings; lighten, darken, mix, tint, shade, adjust alpha, and convert between formats.
- Palette generation —
antGeneratePaletteproduces the signature Ant Design 10-step color scale (blue-1 … blue-10) from any base color, with dark theme support. - Preset palettes — All 13 Ant Design preset colors (red, volcano, orange, gold, yellow, lime, green, cyan, blue, geekblue, purple, magenta, grey) ready to use.
- Flutter-native — Every color is accessible as a Flutter
Coloralongside its hex string. - CSS color parsing —
antParseColorconverts any CSS color string into a FlutterColor.
Getting started
dependencies:
antd_color: ^1.0.0
import 'package:antd_color/antd_color.dart';
Usage
Color manipulation
// Create from any CSS color string (shorthand for AntFastColor.of)
final base = AntFastColor('#1677ff');
// Lighten / darken (amount is a percentage 0-100)
final lighter = base.lighten(20);
final darker = base.darken(10);
// Mix two colors (amount is a percentage 0-100)
final mixed = base.mix('#ffffff', 50);
// Tint / shade (mix with white / black)
final tinted = base.tint(20);
final shaded = base.shade(10);
// Adjust alpha
final semi = base.setA(0.45);
// Convert
print(base.toHexString()); // #1677ff
print(base.toRgb()); // AntRgb(r: 22, g: 119, b: 255)
print(base.toRgbString()); // rgb(22,119,255)
print(base.toHsl()); // AntHsl(h: 215, s: 1.0, l: 0.54)
print(base.toHsv()); // AntHsv(h: 215, s: 0.91, v: 1.0)
// Check brightness
print(base.isDark()); // false
print(base.getLuminance()); // ~0.21 (WCAG relative luminance)
Generate a 10-step palette
// Light theme palette
final palette = antGeneratePalette('#1677ff');
// palette[0] … palette[9] — hex strings, lightest to darkest
// Dark theme palette
final darkPalette = antGeneratePalette(
'#1677ff',
AntPaletteOptions(theme: 'dark', backgroundColor: '#141414'),
);
Preset colors
// All 13 preset palettes (Map<String, List<String>>)
final presets = antGeneratePresetPalettes();
final blue = presets['blue']!; // 10-step hex strings
// Dark variants
final darkPresets = antGeneratePresetPalettes(dark: true);
// Or use the seed constants directly
final seed = AntPresetColors.blue; // #1677FF
AntColor — palette wrapper
// Generate from a seed color (light theme mapping)
final antBlue = AntColor.fromSeed('#1677ff');
// Access by step (1-10) as hex string
print(antBlue.step1); // lightest
print(antBlue.main); // step 6 — the primary color
print(antBlue.step10); // darkest
print(antBlue[5]); // operator access by step number
// Access by step (1-10) as Flutter Color
final primary = antBlue.step6Color;
final hover = antBlue.step5Color;
final active = antBlue.step7Color;
final colorAt3 = antBlue.colorAt(3);
// Dark theme variant
final antBlueDark = AntColor.fromSeedDark('#1677ff');
Parse CSS color strings
// hex / rgb / rgba strings → Flutter Color
final c1 = antParseColor('#1677ff');
final c2 = antParseColor('rgba(22, 119, 255, 0.6)');
Documentation
- API 文档总览(每个公开 API 独立页面,位于 docs/api/)
Porting fidelity
The color algorithms (RGB ↔ HSL ↔ HSV conversion, palette generation with hue/saturation/brightness steps and dark theme mixing) are ported line-by-line from @ant-design/fast-color v3 and validated against its test fixtures to ensure visual parity with Ant Design React.
License
MIT
Libraries
- antd_color
- antd_color — Ant Design v6 颜色系统