К основному содержанию
правило CX Codex

rendering-hydration-no-flicker — правило для Claude Code

Правило rendering-hydration-no-flicker учит агента читать локальное хранилище без ошибок серверного рендеринга и без мигания интерфейса до гидратации.

MIT ★ 7 191 обновлён 2026-10-24

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/rendering-hydration-no-flicker.md
Открыть на GitHub

Что делает rendering-hydration-no-flicker

При серверном рендеринге прямое обращение к localStorage приводит к падению, потому что объект хранилища не существует на сервере. Попытка перенести чтение в хук useEffect решает проблему с падением, но создаёт новую: компонент сначала отрисовывает значение по умолчанию, а затем резко переключается после гидратации.

Инструкция задаёт решение через синхронный строчный тег <script>. Браузер выполняет этот скрипт до отображения элемента и гидратации React, поэтому разметка сразу получает нужный класс без рассинхронизации клиентского и серверного дерева.

Подход рассчитан на чтение пользовательских настроек, переключателей темы оформления и сохранённого состояния входа прямо в браузере.

Какие задачи решает

  • предотвратить ошибки сборки при серверном рендере компонентов с чтением хранилища
  • убрать визуальный скачок интерфейса при чтении сохранённой темы
  • внедрить синхронную инициализацию классов разметки до старта гидратации
  • сохранить целостность дерева компонентов между сервером и клиентом

Примеры запросов агенту

  • Настрой чтение выбранной темы оформления из локального хранилища без мигания экрана при загрузке.
  • Перепиши логику клиентских настроек, чтобы убрать ошибку несовпадения серверной и клиентской разметки.
  • Добавь синхронный скрипт для присвоения класса контейнеру до завершения гидратации.

Как установить rendering-hydration-no-flicker

Вручную: положить файлы

.claude/rules/rendering-hydration-no-flicker.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: 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

Похожие правила IDE

Все правила IDE по теме «Фронтенд и UI» →
react-selective-hydration patterns.dev Скилл react-selective-hydration для Claude Code учит агента настраивать выборочную гидратацию и потоковый SSR в React 18+. Ускоряет интерактивность страниц с тяжёлыми компонентами и запросами данных. CX Codex +1 1 000установок progressive-hydration patterns.dev Скилл progressive-hydration для Claude Code помогает распределить клиентскую гидратацию по приоритету. Он подключается при работе с SSR-страницами, где части интерфейса могут ждать JavaScript. CX Codex +1 1 000установок hydration-guardian oakoss Скилл hydration-guardian ловит расхождение серверной разметки и клиентского React-дерева: по тексту ошибки находит причину и подсказывает, какой приём гидратации применить. CX Codex +1 144установок execution-model TanStack Скилл execution-model помогает агенту правильно разделять серверный и клиентский код в TanStack Start и учитывать SSR, гидрацию и переменные окружения. CX Codex +1 214установок nuxt4-patterns affaan-m Скилл nuxt4-patterns для работы с Nuxt 4: гидратация, route rules, ленивая загрузка и SSR-безопасный сбор данных через useFetch и useAsyncData. CX Codex +1 6 300установок angular-ssr analogjs Скилл angular-ssr для Claude Code описывает SSR и гидратацию в Angular. Он помечен как устаревший, а его прежние инструкции удалены. CX Codex +1 4 000установок

Из того же набора130

Весь набор →
server-dedup-props server-dedup-props — правило для Claude Code о дедупликации данных в React Server Components. Объясняет, почему серверные трансформации массивов дублируют payload и их следует переносить в клиент. CX Codex +1 ★ 7 191звёзд репо rendering-usetransition-loading Правило rendering-usetransition-loading для Claude Code переводит индикатор загрузки в React-компонентах с ручного useState на useTransition. Спиннер живёт на отдельном флаге — правило его убирает. CX Codex +1 ★ 7 191звёзд репо server-cache-react Правило server-cache-react учит ассистента мемоизировать серверные запросы через React.cache() и избегать повторных обращений к базе данных. CX Codex +1 ★ 7 191звёзд репо architecture-avoid-boolean-props Правило architecture-avoid-boolean-props запрещает раздувать компоненты булевыми пропсами и предлагает собирать варианты через композицию. Пригодится при проектировании React-компонентов. CX Codex +1 ★ 7 191звёзд репо bundle-barrel-imports Правило bundle-barrel-imports для Claude Code подсказывает импортировать модули напрямую, а не через barrel-файлы. Указывает прямые пути модулей в React-пакетах и библиотеках с большим числом реэкспортов. CX Codex +1 ★ 7 191звёзд репо patterns-explicit-variants Правило patterns-explicit-variants требует собирать каждый режим компонента отдельным компонентом вместо набора булевых пропсов. По вызову сразу видно, что отрисуется. CX Codex +1 ★ 7 191звёзд репо async-suspense-boundaries Правило async-suspense-boundaries направляет Claude Code выносить загрузку данных в отдельные компоненты с Suspense, чтобы каркас страницы рендерился без задержек. CX Codex +1 ★ 7 191звёзд репо architecture-compound-components Правило architecture-compound-components предлагает собирать сложные компоненты из частей с общим контекстом. Оно пригодится, когда монолитный компонент обрастает условиями и render props. CX Codex +1 ★ 7 191звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой