Color system builder
Принцип — oklch + ramp. Все цвета одного семейства имеют одинаковую chroma, варьируется lightness. Это даёт визуально согласованные шкалы, которых не получишь подбором HEX'ов.
Скрипт
templates/build-palette.mjs:
node build-palette.mjs "#D97757"
# → palette.css + palette.json
Делает:
- 9-step scale базового цвета (50, 100, 200, ..., 900)
- light + dark theme tokens
- semantic: success / warning / danger / info — той же интенсивности
- проверка WCAG AA контраста для каждой пары fg/bg
Алгоритм
- Парсим вход → oklch.
- Для шкалы фиксируем chroma и hue, варьируем lightness:
- 50: L=98%
- 100: L=95%
- 200: L=90%
- 300: L=82%
- 400: L=72%
- 500: L=62% (исходный)
- 600: L=52%
- 700: L=42%
- 800: L=32%
- 900: L=20%
- Semantic — те же L/C, разные H:
- danger: H=25
- warning: H=80
- success: H=145
- info: H=245
- Контраст проверяется через WCAG-формулу.
Скрипт целиком
import fs from 'node:fs/promises';
import { converter, formatHex, wcagContrast } from 'culori';
const arg = process.argv[2];
if (!arg) { console.error('Usage: node build-palette.mjs <color>'); process.exit(1); }
const oklch = converter('oklch')(arg);
const C = oklch.c, H = oklch.h;
const steps = [98, 95, 90, 82, 72, 62, 52, 42, 32, 20];
const names = [50, 100, 200, 300, 400, 500, 600, 700, 800, 900];
function ramp(hue, chroma) {
const out = {};
steps.forEach((L, i) => {
out[names[i]] = formatHex({ mode: 'oklch', l: L/100, c: chroma, h: hue });
});
return out;
}
const palette = {
primary: ramp(H, C),
neutral: ramp(H, 0.01), // тонированный серый, не «компьютерный»
success: ramp(145, C),
warning: ramp(80, C),
danger: ramp(25, C),
info: ramp(245, C),
};
// Светлая и тёмная тема — semantic mappings
const tokens = {
light: {
bg: palette.neutral[50],
fg: palette.neutral[900],
muted: palette.neutral[600],
rule: palette.neutral[200],
primary: palette.primary[500],
'primary-fg': palette.primary[50],
},
dark: {
bg: palette.neutral[900],
fg: palette.neutral[50],
muted: palette.neutral[400],
rule: palette.neutral[800],
primary: palette.primary[400],
'primary-fg': palette.primary[900],
},
};
// Контраст
function check(fg, bg) {
const c = wcagContrast(fg, bg);
return { ratio: c.toFixed(2), passAA: c >= 4.5, passLarge: c >= 3 };
}
const audit = {
'light fg/bg': check(tokens.light.fg, tokens.light.bg),
'light muted/bg': check(tokens.light.muted, tokens.light.bg),
'light primary-fg/primary': check(tokens.light['primary-fg'], tokens.light.primary),
'dark fg/bg': check(tokens.dark.fg, tokens.dark.bg),
'dark muted/bg': check(tokens.dark.muted, tokens.dark.bg),
};
await fs.writeFile('palette.json', JSON.stringify({ palette, tokens, audit }, null, 2));
let css = ':root {\n';
for (const [k, v] of Object.entries(tokens.light)) css += ` --${k}: ${v};\n`;
css += '}\n[data-theme="dark"] {\n';
for (const [k, v] of Object.entries(tokens.dark)) css += ` --${k}: ${v};\n`;
css += '}\n\n';
for (const [name, ramp] of Object.entries(palette)) {
for (const [step, hex] of Object.entries(ramp)) {
css += `:root { --${name}-${step}: ${hex}; }\n`;
}
}
await fs.writeFile('palette.css', css);
console.log('✓ palette.css + palette.json');
console.table(audit);
Зависимость: npm i culori.
Что делать с выводом
palette.css подключай в проект первым.
palette.json отдай разработчику или используй в dev-handoff.
- Если в
audit есть passAA: false для основных пар — палитра плохая, поправь L-значения.
1---2name: color-system-builder3version: 1.0.04description: "Из одного акцента — полная палитра: light+dark, 9-step scale, semantic, WCAG-контраст. Триггеры: «построй цветовую систему», «color tokens»."5metadata:6 source: https://skillmd.com/skills/jhamidun/color-system-builder7---89# Color system builder1011Принцип — **oklch + ramp**. Все цвета одного семейства имеют одинаковую chroma, варьируется lightness. Это даёт визуально согласованные шкалы, которых не получишь подбором HEX'ов.1213## Скрипт1415`templates/build-palette.mjs`:1617```bash18node build-palette.mjs "#D97757"19# → palette.css + palette.json20```2122Делает:23- 9-step scale базового цвета (50, 100, 200, ..., 900)24- light + dark theme tokens25- semantic: success / warning / danger / info — той же интенсивности26- проверка WCAG AA контраста для каждой пары fg/bg2728## Алгоритм29301. Парсим вход → oklch.312. Для шкалы фиксируем chroma и hue, варьируем lightness:32 - 50: L=98%33 - 100: L=95%34 - 200: L=90%35 - 300: L=82%36 - 400: L=72%37 - 500: L=62% (исходный)38 - 600: L=52%39 - 700: L=42%40 - 800: L=32%41 - 900: L=20%423. Semantic — те же L/C, разные H:43 - danger: H=2544 - warning: H=8045 - success: H=14546 - info: H=245474. Контраст проверяется через WCAG-формулу.4849## Скрипт целиком5051```js52import fs from 'node:fs/promises';53import { converter, formatHex, wcagContrast } from 'culori';5455const arg = process.argv[2];56if (!arg) { console.error('Usage: node build-palette.mjs <color>'); process.exit(1); }5758const oklch = converter('oklch')(arg);59const C = oklch.c, H = oklch.h;6061const steps = [98, 95, 90, 82, 72, 62, 52, 42, 32, 20];62const names = [50, 100, 200, 300, 400, 500, 600, 700, 800, 900];6364function ramp(hue, chroma) {65 const out = {};66 steps.forEach((L, i) => {67 out[names[i]] = formatHex({ mode: 'oklch', l: L/100, c: chroma, h: hue });68 });69 return out;70}7172const palette = {73 primary: ramp(H, C),74 neutral: ramp(H, 0.01), // тонированный серый, не «компьютерный»75 success: ramp(145, C),76 warning: ramp(80, C),77 danger: ramp(25, C),78 info: ramp(245, C),79};8081// Светлая и тёмная тема — semantic mappings82const tokens = {83 light: {84 bg: palette.neutral[50],85 fg: palette.neutral[900],86 muted: palette.neutral[600],87 rule: palette.neutral[200],88 primary: palette.primary[500],89 'primary-fg': palette.primary[50],90 },91 dark: {92 bg: palette.neutral[900],93 fg: palette.neutral[50],94 muted: palette.neutral[400],95 rule: palette.neutral[800],96 primary: palette.primary[400],97 'primary-fg': palette.primary[900],98 },99};100101// Контраст102function check(fg, bg) {103 const c = wcagContrast(fg, bg);104 return { ratio: c.toFixed(2), passAA: c >= 4.5, passLarge: c >= 3 };105}106const audit = {107 'light fg/bg': check(tokens.light.fg, tokens.light.bg),108 'light muted/bg': check(tokens.light.muted, tokens.light.bg),109 'light primary-fg/primary': check(tokens.light['primary-fg'], tokens.light.primary),110 'dark fg/bg': check(tokens.dark.fg, tokens.dark.bg),111 'dark muted/bg': check(tokens.dark.muted, tokens.dark.bg),112};113114await fs.writeFile('palette.json', JSON.stringify({ palette, tokens, audit }, null, 2));115116let css = ':root {\n';117for (const [k, v] of Object.entries(tokens.light)) css += ` --${k}: ${v};\n`;118css += '}\n[data-theme="dark"] {\n';119for (const [k, v] of Object.entries(tokens.dark)) css += ` --${k}: ${v};\n`;120css += '}\n\n';121for (const [name, ramp] of Object.entries(palette)) {122 for (const [step, hex] of Object.entries(ramp)) {123 css += `:root { --${name}-${step}: ${hex}; }\n`;124 }125}126await fs.writeFile('palette.css', css);127128console.log('✓ palette.css + palette.json');129console.table(audit);130```131132Зависимость: `npm i culori`.133134## Что делать с выводом135136- `palette.css` подключай в проект первым.137- `palette.json` отдай разработчику или используй в `dev-handoff`.138- Если в `audit` есть `passAA: false` для основных пар — палитра плохая, поправь L-значения.