rendering-hydration-no-flicker — правило для Claude Code
Правило rendering-hydration-no-flicker учит агента читать локальное хранилище без ошибок серверного рендеринга и без мигания интерфейса до гидратации.
MIT ★ 7 191 обновлён 2026-10-24
.claude/rules/rendering-hydration-no-flicker.mdЧто делает rendering-hydration-no-flicker
При серверном рендеринге прямое обращение к localStorage приводит к падению, потому что объект хранилища не существует на сервере. Попытка перенести чтение в хук useEffect решает проблему с падением, но создаёт новую: компонент сначала отрисовывает значение по умолчанию, а затем резко переключается после гидратации.
Инструкция задаёт решение через синхронный строчный тег <script>. Браузер выполняет этот скрипт до отображения элемента и гидратации React, поэтому разметка сразу получает нужный класс без рассинхронизации клиентского и серверного дерева.
Подход рассчитан на чтение пользовательских настроек, переключателей темы оформления и сохранённого состояния входа прямо в браузере.
Какие задачи решает
- предотвратить ошибки сборки при серверном рендере компонентов с чтением хранилища
- убрать визуальный скачок интерфейса при чтении сохранённой темы
- внедрить синхронную инициализацию классов разметки до старта гидратации
- сохранить целостность дерева компонентов между сервером и клиентом
Примеры запросов агенту
- Настрой чтение выбранной темы оформления из локального хранилища без мигания экрана при загрузке.
- Перепиши логику клиентских настроек, чтобы убрать ошибку несовпадения серверной и клиентской разметки.
- Добавь синхронный скрипт для присвоения класса контейнеру до завершения гидратации.
Как установить rendering-hydration-no-flicker
Вручную: положить файлы
.claude/rules/rendering-hydration-no-flicker.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/rendering-hydration-no-flicker.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/rendering-hydration-no-flicker.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/rendering-hydration-no-flicker.mdВручную: положить файлы
.clinerules/rendering-hydration-no-flicker.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о rendering-hydration-no-flicker
Как установить rendering-hydration-no-flicker в Claude Code?
Сохраните файл правила по пути .claude/rules/rendering-hydration-no-flicker.md в корне вашего проекта.
Что делает правило rendering-hydration-no-flicker?
Оно направляет ИИ-агента на использование встроенного синхронного скрипта вместо хука useEffect при отрисовке данных из браузерного хранилища.
Почему чтение хранилища через useEffect считается проблемным?
Код внутри хука срабатывает только после гидратации на клиенте, поэтому интерфейс успевает показать значение по умолчанию и резко моргает.
Исходный текст
rendering-hydration-no-flicker.md · MIT
---
title: Prevent Hydration Mismatch Without Flickering
impact: MEDIUM
impactDescription: avoids visual flicker and hydration errors
tags: rendering, ssr, hydration, localStorage, flicker
---
## Prevent Hydration Mismatch Without Flickering
When rendering content that depends on client-side storage (localStorage, cookies), avoid both SSR breakage and post-hydration flickering by injecting a synchronous script that updates the DOM before React hydrates.
**Incorrect (breaks SSR):**
```tsx
function ThemeWrapper({ children }: { children: ReactNode }) {
// localStorage is not available on server - throws error
const theme = localStorage.getItem('theme') || 'light'
return (
<div className={theme}>
{children}
</div>
)
}
```
Server-side rendering will fail because `localStorage` is undefined.
**Incorrect (visual flickering):**
```tsx
function ThemeWrapper({ children }: { children: ReactNode }) {
const [theme, setTheme] = useState('light')
useEffect(() => {
// Runs after hydration - causes visible flash
const stored = localStorage.getItem('theme')
if (stored) {
setTheme(stored)
}
}, [])
return (
<div className={theme}>
{children}
</div>
)
}
```
Component first renders with default value (`light`), then updates after hydration, causing a visible flash of incorrect content.
**Correct (no flicker, no hydration mismatch):**
```tsx
function ThemeWrapper({ children }: { children: ReactNode }) {
return (
<>
<div id="theme-wrapper">
{children}
</div>
<script
dangerouslySetInnerHTML={{
__html: `
(function() {
try {
var theme = localStorage.getItem('theme') || 'light';
var el = document.getElementById('theme-wrapper');
if (el) el.className = theme;
} catch (e) {}
})();
`,
}}
/>
</>
)
}
```
The inline script executes synchronously before showing the element, ensuring the DOM already has the correct value. No flickering, no hydration mismatch.
This pattern is especially useful for theme toggles, user preferences, authentication states, and any client-only data that should render immediately without flashing default values.
© tech-leads-club · MIT · tech-leads-club/agent-skills