Tweaks panel
Готовые React-компоненты для in-design панели настроек: ползунки, переключатели, цвета, варианты-радио.
Файлы
templates/tweaks-panel.jsx — <TweaksPanel>, хук useTweaks, контролы TweakSlider, TweakToggle, TweakRadio, TweakSelect, TweakColor, TweakText, TweakNumber.
templates/example.html — рабочий пример, где меняются цвет, размер шрифта, тёмная тема.
Использование
function App() {
const [tweaks, setTweak] = useTweaks({
primary: '#D97757',
fontSize: 16,
dark: false,
layout: 'A',
});
return (
<div style={{
background: tweaks.dark ? '#111' : '#fff',
color: tweaks.dark ? '#fff' : '#111',
fontSize: tweaks.fontSize,
}}>
...макет...
<TweaksPanel>
<TweakSection title="Цвет">
<TweakColor label="Primary" value={tweaks.primary} => setTweak('primary', v)} />
</TweakSection>
<TweakSection title="Текст">
<TweakSlider label="Размер" min={12} max={24} step={1}
value={tweaks.fontSize} => setTweak('fontSize', v)} />
</TweakSection>
<TweakSection title="Тема">
<TweakToggle label="Тёмная" value={tweaks.dark} => setTweak('dark', v)} />
</TweakSection>
<TweakSection title="Layout">
<TweakRadio value={tweaks.layout} options={['A', 'B', 'C']}
=> setTweak('layout', v)} />
</TweakSection>
</TweaksPanel>
</div>
);
}
Persistence
useTweaks пишет состояние в localStorage под ключом tweaks.<page-path>. Рефреш страницы — состояние остаётся. Чтобы сбросить: кнопка «Reset» в углу панели или localStorage.clear().
Persistence на диск (бывший скилл tweaks-persist)
Если нужно, чтобы значения переживали не только refresh, но и попадали в исходник (EDITMODE-маркеры + WebSocket-сервер на :5175) — полная инструкция в references/tweaks-persist-file-writeback.md. Прежняя расширенная версия (запись в tokens.css через HTTP :8082, sidecar JSON .tweaks/, multi-state сравнение версий, reset, антипаттерны) — references/legacy-tweaks-persist.md.
Когда добавлять
- Если пользователь явно просит варианты, а сразу делать N HTML-файлов — оверкилл.
- Если хочется дать манагеру/клиенту повертеть прототип самому.
- Если в дизайне есть параметры, которые трудно решить без живого превью (плотность, цвет, копирайт).
Чего не делать
- Не пихай в Tweaks ВСЕ возможные параметры. Это не настройки приложения. 4–8 ключевых тумблеров — потолок.
- Не делай Tweaks основным UI. Это инструмент дизайнера, не пользователя.
- Если параметров много — группируй в секции, не вали в один длинный список.
Legacy reference
Прежняя расширенная версия скилла (дерево @2026-04-30) сохранена целиком в references/legacy-tweaks-panel.md. Секции там: Каркас, Использование в App, Какие тёрлы стоит давать, tweaks-persist (если установлен), Антипаттерны.
1---2name: tweaks-panel-23description: "Панель крутилок в прототипе: цвета, шрифты, варианты; localStorage + запись в исходник. Триггеры: «крутилки в прототипе», «запиши в tokens.css»."4metadata:5 source: https://skillmd.com/skills/jhamidun/tweaks-panel-26---78# Tweaks panel910Готовые React-компоненты для in-design панели настроек: ползунки, переключатели, цвета, варианты-радио.1112## Файлы1314- `templates/tweaks-panel.jsx` — `<TweaksPanel>`, хук `useTweaks`, контролы `TweakSlider`, `TweakToggle`, `TweakRadio`, `TweakSelect`, `TweakColor`, `TweakText`, `TweakNumber`.15- `templates/example.html` — рабочий пример, где меняются цвет, размер шрифта, тёмная тема.1617## Использование1819```jsx20function App() {21 const [tweaks, setTweak] = useTweaks({22 primary: '#D97757',23 fontSize: 16,24 dark: false,25 layout: 'A',26 });2728 return (29 <div style={{30 background: tweaks.dark ? '#111' : '#fff',31 color: tweaks.dark ? '#fff' : '#111',32 fontSize: tweaks.fontSize,33 }}>34 ...макет...3536 <TweaksPanel>37 <TweakSection title="Цвет">38 <TweakColor label="Primary" value={tweaks.primary} onChange={v => setTweak('primary', v)} />39 </TweakSection>40 <TweakSection title="Текст">41 <TweakSlider label="Размер" min={12} max={24} step={1}42 value={tweaks.fontSize} onChange={v => setTweak('fontSize', v)} />43 </TweakSection>44 <TweakSection title="Тема">45 <TweakToggle label="Тёмная" value={tweaks.dark} onChange={v => setTweak('dark', v)} />46 </TweakSection>47 <TweakSection title="Layout">48 <TweakRadio value={tweaks.layout} options={['A', 'B', 'C']}49 onChange={v => setTweak('layout', v)} />50 </TweakSection>51 </TweaksPanel>52 </div>53 );54}55```5657## Persistence5859`useTweaks` пишет состояние в `localStorage` под ключом `tweaks.<page-path>`. Рефреш страницы — состояние остаётся. Чтобы сбросить: кнопка «Reset» в углу панели или `localStorage.clear()`.6061### Persistence на диск (бывший скилл tweaks-persist)6263Если нужно, чтобы значения переживали не только refresh, но и попадали в исходник (EDITMODE-маркеры + WebSocket-сервер на :5175) — полная инструкция в `references/tweaks-persist-file-writeback.md`. Прежняя расширенная версия (запись в tokens.css через HTTP :8082, sidecar JSON `.tweaks/`, multi-state сравнение версий, reset, антипаттерны) — `references/legacy-tweaks-persist.md`.6465## Когда добавлять6667- Если пользователь явно просит варианты, а сразу делать N HTML-файлов — оверкилл.68- Если хочется дать манагеру/клиенту повертеть прототип самому.69- Если в дизайне есть параметры, которые трудно решить без живого превью (плотность, цвет, копирайт).7071## Чего не делать7273- Не пихай в Tweaks ВСЕ возможные параметры. Это не настройки приложения. 4–8 ключевых тумблеров — потолок.74- Не делай Tweaks основным UI. Это инструмент дизайнера, не пользователя.75- Если параметров много — группируй в секции, не вали в один длинный список.7677## Legacy reference7879Прежняя расширенная версия скилла (дерево @2026-04-30) сохранена целиком в `references/legacy-tweaks-panel.md`. Секции там: Каркас, Использование в App, Какие тёрлы стоит давать, tweaks-persist (если установлен), Антипаттерны.