antd_tokens 1.0.1
antd_tokens: ^1.0.1 copied to clipboard
Ant Design v6 Design Token system. Seed tokens, token generation algorithms, color token maps, and shadow tokens.
antd_tokens - Ant Design v6 design tokens for Flutter #
antd_tokens is the token layer of the antd_flutter stack. It ports Ant Design v6's seed tokens, token generators, color alias maps, and shadow tokens into pure Dart. The package answers one question for every downstream widget: given a seed (primary color, font size, radius base, control height), what exact value should a component use for colorTextSecondary, fontSizeHeading1, or controlHeightSM?
Keeping generation separate from theming is intentional. The generators are plain functions with no BuildContext, no widgets, and no inherited state, so the same algorithms can run in tests, CLI tools, or a theme object. AntSeedToken is immutable and copyWith-friendly; AntColorTokens and AntShadowTokens produce Flutter Color and BoxShadow values while also exposing the original CSS strings through AntColorTokensCss for producers that emit CSS variables.
Positioning & design #
- Seed → map → alias, exactly as antd does it. Each generator mirrors the corresponding antd function (
genFontSizes,genRadius,genSizeMapToken,genControlHeight, and the motion part ofgenCommonMapToken), including its rounding and clamping rules. - Functions, not framework objects. Every generator is a top-level function that returns an immutable value object. There is no hidden global state and no dependency on Flutter's widget tree.
- Light and dark are two mappings of the same seeds.
AntColorTokens.lightand.darkshare the alias names; only the mapping tables differ, so component code never branches on brightness. - CSS strings stay available.
AntColorTokensCssexposes the raw values (#1677ff,rgba(...)) next to the parsedColorgetters, which keeps web and mobile outputs aligned. - Shadows are generated from one color.
AntShadowTokens.generatederives all 13 elevation sets from a single shadow color, so dark themes only need to change that input.
Installation #
Requires Dart 3.0+ and Flutter 3.10+.
dependencies:
antd_tokens: ^1.0.0
Quick start #
import 'package:antd_tokens/antd_tokens.dart';
void main() {
// Start from antd defaults and override only what the brand changes.
const seed = AntSeedToken();
final brand = seed.copyWith(colorPrimary: '#722ed1', borderRadius: 8);
// Generators turn scalar seeds into complete ladders.
print(antGenFontMapToken(brand.fontSize).fontSizeLG); // 16
print(antGenRadius(brand.borderRadius).borderRadiusLG); // 8
// Color aliases are generated as one map per brightness.
final colors = AntColorTokens.light(brand);
print(colors.colorPrimary);
}
API #
Derive size, height, and motion ladders #
import 'package:antd_tokens/antd_tokens.dart';
void main() {
final sizes = antGenSizeMapToken(sizeUnit: 4, sizeStep: 4);
print(sizes.size); // 16
print(sizes.sizeXXL); // 48
final heights = antGenControlHeight(32);
print(heights.controlHeightSM); // 24
final motion = antGenMotionDuration(
motionUnit: 0.1,
motionBase: 0,
motion: true,
);
print(motion.mid); // 0.2
}
Read color aliases for light and dark #
import 'package:antd_tokens/antd_tokens.dart';
void main() {
final light = AntColorTokens.light(const AntSeedToken());
print(light.colorPrimary);
print(light.css.colorPrimary); // '#1677ff'
final dark = AntColorTokens.dark(AntSeedToken.dark());
print(dark.colorBgContainer);
}
Build elevation from one shadow color #
import 'package:antd_tokens/antd_tokens.dart';
void main() {
final shadows = AntShadowTokens.generate('#000000');
print(shadows.boxShadow.length);
print(shadows.boxShadowSecondary);
}
Demo #
- Live demo: https://flutter-open.github.io/antd-flutter/tokens/
- Found a bug or have a question? Open an issue
Project structure #
antd_tokens/
├── lib/
│ ├── antd_tokens.dart # Public barrel
│ └── src/
│ ├── ant_seed_token.dart # Seed token + light/dark factories
│ ├── ant_token_generators.dart # Generator aggregate export
│ ├── ant_color_tokens.dart # Color alias map (light/dark)
│ ├── ant_shadow_tokens.dart # Elevation sets
│ ├── generators/ # Font, radius, size, height, motion
│ └── css/ # AntColorTokensCss raw strings
├── test/
│ ├── ant_color_tokens_test.dart
│ ├── ant_seed_token_test.dart
│ ├── ant_shadow_tokens_test.dart
│ └── ant_token_generators_test.dart
└── docs/
├── api-index.md
└── api/
License #
MIT
☕ Buy Me a Coffee #
If this project has been helpful to you, you are welcome to buy me a coffee. Thank you for your support!
| Alipay | |
|---|---|
![]() |
![]() |

