rendering-resource-hints — правило для Claude Code
Правило rendering-resource-hints учит агента вставлять в React-компоненты вызовы API React DOM для подсказок браузеру о ресурсах. Встраивается в серверные компоненты, чтобы загрузка файлов стартовала раньше, чем клиент получит HTML.
MIT ★ 1 216 обновлён 2026-10-24
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install react-skills@claude-settingsЧто делает rendering-resource-hints
Правило описывает шесть функций React DOM — prefetchDNS, preconnect, preload, preloadModule, preinit, preinitModule — и когда какую применять. prefetchDNS резолвит домен заранее, preconnect поднимает соединение целиком (DNS, TCP, TLS) для API или CDN, с которыми сразу начнётся обмен данными. preload и preinit тянут конкретный файл: шрифт, стиль, скрипт или изображение, причём preinit сразу его выполняет, а preload просто кладёт в кэш браузера.
Для отдельных модулей есть preloadModule и preinitModule: первый пригоден для вероятного перехода на следующий экран (например, по onMouseEnter на ссылке), второй — для кода, который должен выполниться немедленно. В примерах правило показывает, как сделать preconnect к сторонним API в компоненте App, подготовить шрифт и критический CSS в RootLayout, и подгрузить модуль дашборда при наведении на ссылку навигации.
Все вызовы работают через пакет react-dom и рассчитаны на серверные компоненты React, где подсказки браузеру можно отдать до того, как HTML уйдёт клиенту.
Какие задачи решает
- расставить
preconnectиprefetchDNSдля сторонних API - подключить
preloadдля шрифтов и критических стилей - подготовить
preinitдля стилей, которые должны сработать немедленно - ускорить переход на код-сплит-маршруты через
preloadModule - выбрать нужный API resource hints по таблице из правила
Примеры запросов агенту
- Добавь preconnect к api.example.com в компоненте App
- Настрой preload критического шрифта в RootLayout через preload с type font/woff2
- Сделай preloadModule для /dashboard.js при наведении на ссылку в навигации
Как установить rendering-resource-hints
1Через маркетплейс плагинов
/plugin marketplace add fcakyon/claude-codex-settings/plugin install react-skills@claude-settings2Вручную: положить файлы
.claude/rules/rendering-resource-hints.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/rendering-resource-hints.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/rendering-resource-hints.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/rendering-resource-hints.mdВручную: положить файлы
.clinerules/rendering-resource-hints.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о rendering-resource-hints
Как установить rendering-resource-hints в Claude Code?
Выполните /plugin marketplace add fcakyon/claude-codex-settings, затем /plugin install react-skills@claude-settings.
Что делает rendering-resource-hints?
Правило подсказывает агенту, когда вставлять в React-код вызовы prefetchDNS, preconnect, preload, preloadModule, preinit и preinitModule из react-dom, чтобы браузер начинал грузить нужные ресурсы раньше.
Для каких платформ есть это правило?
Файл правила кладётся в .claude/rules/rendering-resource-hints.md для Claude Code; также есть варианты для Cursor, GitHub Copilot, Windsurf и Cline в их собственных форматах.
Исходный текст
rendering-resource-hints.md · MIT
---
title: Use React DOM Resource Hints
impact: HIGH
impactDescription: reduces load time for critical resources
tags: rendering, preload, preconnect, prefetch, resource-hints
---
## Use React DOM Resource Hints
**Impact: HIGH (reduces load time for critical resources)**
React DOM provides APIs to hint the browser about resources it will need. These are especially useful in server components to start loading resources before the client even receives the HTML.
- **`prefetchDNS(href)`**: Resolve DNS for a domain you expect to connect to
- **`preconnect(href)`**: Establish connection (DNS + TCP + TLS) to a server
- **`preload(href, options)`**: Fetch a resource (stylesheet, font, script, image) you'll use soon
- **`preloadModule(href)`**: Fetch an ES module you'll use soon
- **`preinit(href, options)`**: Fetch and evaluate a stylesheet or script
- **`preinitModule(href)`**: Fetch and evaluate an ES module
**Example (preconnect to third-party APIs):**
```tsx
import { preconnect, prefetchDNS } from 'react-dom'
export default function App() {
prefetchDNS('https://analytics.example.com')
preconnect('https://api.example.com')
return <main>{/* content */}</main>
}
```
**Example (preload critical fonts and styles):**
```tsx
import { preload, preinit } from 'react-dom'
export default function RootLayout({ children }) {
// Preload font file
preload('/fonts/inter.woff2', { as: 'font', type: 'font/woff2', crossOrigin: 'anonymous' })
// Fetch and apply critical stylesheet immediately
preinit('/styles/critical.css', { as: 'style' })
return (
<html>
<body>{children}</body>
</html>
)
}
```
**Example (preload modules for code-split routes):**
```tsx
import { preloadModule, preinitModule } from 'react-dom'
function Navigation() {
const preloadDashboard = () => {
preloadModule('/dashboard.js', { as: 'script' })
}
return (
<nav>
<a href="/dashboard" onMouseEnter={preloadDashboard}>
Dashboard
</a>
</nav>
)
}
```
**When to use each:**
| API | Use case |
|-----|----------|
| `prefetchDNS` | Third-party domains you'll connect to later |
| `preconnect` | APIs or CDNs you'll fetch from immediately |
| `preload` | Critical resources needed for current page |
| `preloadModule` | JS modules for likely next navigation |
| `preinit` | Stylesheets/scripts that must execute early |
| `preinitModule` | ES modules that must execute early |
Reference: [React DOM Resource Preloading APIs](https://react.dev/reference/react-dom#resource-preloading-apis)
© fcakyon · MIT · fcakyon/claude-codex-settings