# loading-suspense

Правило loading-suspense требует оборачивать асинхронные компоненты React Three Fiber в Suspense с заглушкой: без границы сцена останется пустой, пока грузится модель или текстура.

- правило · `type=rule` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 4719 у репозитория
- Автор: zebbern
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/zebbern/claude-code-guide/tree/HEAD/skills/r3f-best-practices/rules/loading-suspense.md
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/rules/loading-suspense

## Что делает

Правило для сцен на React Three Fiber. Компонент, который тянет ассеты через `useGLTF` или `useTexture`, приостанавливает рендер, пока файл не догрузится. Поэтому его нужно ставить внутрь `<Suspense>` с запасным вариантом — иначе показывать в этот момент нечего.

Внутри лежат готовые куски кода: одна модель внутри `Canvas`, несколько асинхронных компонентов на общей границе, вложенные границы, где окружение грузится отдельно, а персонаж держит видимый загрузчик. Прогресс собирается из `useProgress` в `@react-three/drei`: хук отдаёт `active`, `progress` и имя текущего `item`.

Сбои закрывает `ErrorBoundary` из пакета `react-error-boundary` поверх `Suspense`, с кнопкой повтора. Этот пакет придётся добавить в зависимости: React своего `ErrorBoundary` не отдаёт. Ещё приём — предзагрузка на уровне модуля: `useGLTF.preload('/model.glb')` кладёт ассет в кеш, и компонент дальше рендерится сразу.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/rules/loading-suspense.md` — Поле paths во frontmatter ограничивает файлы

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/rules/loading-suspense.mdc` — Во frontmatter: description, globs, alwaysApply

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/instructions/loading-suspense.instructions.md` — Поле applyTo задаёт, к каким файлам применять

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/loading-suspense.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/loading-suspense.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/zebbern/claude-code-guide/tree/HEAD/skills/r3f-best-practices/rules/loading-suspense.md

## Когда брать
- обернуть модель из `useGLTF` в границу Suspense с заглушкой
- показать прогресс загрузки сцены через `useProgress`
- развести загрузку окружения и персонажа по вложенным границам
- поймать ошибку загрузки `.glb` и дать кнопку повтора
- убрать мигание заглушки предзагрузкой текстур

## Примеры запросов агенту
- Оберни компонент с `useGLTF` в `<Suspense>` и сделай wireframe-заглушку на время загрузки
- Добавь `ErrorBoundary` из `react-error-boundary` вокруг сцены с моделью
- Предзагрузи `/model.glb` через `useGLTF.preload`, чтобы сцена не мигала

## Похожие
- [react-three-fiber](https://affpapa.org/nevibecode/skills/react-three-fiber.md) — скилл · 4300 установок
- [r3f-loaders](https://affpapa.org/nevibecode/skills/r3f-loaders.md) — скилл · 2100 установок
- [threejs-r3f](https://affpapa.org/nevibecode/skills/threejs-r3f.md) — скилл · 1000 установок
- [react-three-fiber-architect](https://affpapa.org/nevibecode/agents/react-three-fiber-architect.md) — субагент · ★ 1428 у репозитория
- [nextjs-use-search-params-suspense](https://affpapa.org/nevibecode/skills/nextjs-use-search-params-suspense.md) — скилл · 313 установок
- [sanity-form-component-suspense](https://affpapa.org/nevibecode/skills/sanity-form-component-suspense.md) — скилл · 271 установка

Из того же набора: [zebbern/claude-code-guide](https://affpapa.org/nevibecode/by/zebbern/claude-code-guide.md) — 86 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
