animation-gpu-properties — правило для Claude Code
Правило animation-gpu-properties уводит анимации с width, height, top, left, margin и padding на transform и opacity, чтобы не пересчитывать layout на каждом кадре.
MIT ★ 1 216 обновлён 2026-10-24
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install react-skills@claude-settingsЧто делает animation-gpu-properties
Правило перечисляет свойства, которых не должно быть в анимации: width, height, top, left, margin, padding. Каждый кадр с ними заново считает layout. Взамен предлагаются transform (scale, translate, rotate) и opacity — они уходят на GPU и layout не трогают. В шапке файла стоит impact: HIGH.
Внутри три примера на react-native-reanimated. Первый показывает, как делать не надо: панель анимирует height от 0 до 200. Второй переписывает её на scaleY и opacity, а высоту оставляет фиксированной (height: 200, transformOrigin: 'top'). Третий — выезд через translateY со 100 до 0 вместе с прозрачностью.
Примеры вызывают useAnimatedStyle и withTiming из react-native-reanimated. В проекте с другим animation API шаблоны придётся переносить на него вручную, копипастой они не заработают.
Какие задачи решает
- убрать анимацию
heightиз раскрывающейся панели - перевести выезд модалки на
translateY - найти в компонентах анимации
marginиpadding - показать, как переписать переход на
scaleYиopacity - объяснить, почему анимация размера грузит layout
Примеры запросов агенту
- Перепиши анимацию панели на
scaleYиopacity,heightоставь фиксированной. - Проверь компонент
SlideIn: не анимируются ли тамtopилиmargin, и замени их наtranslateY. - Найди во всех компонентах анимации
width,height,paddingиmargin.
Как установить animation-gpu-properties
1Через маркетплейс плагинов
/plugin marketplace add fcakyon/claude-codex-settings/plugin install react-skills@claude-settings2Вручную: положить файлы
.claude/rules/animation-gpu-properties.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/animation-gpu-properties.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/animation-gpu-properties.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/animation-gpu-properties.mdВручную: положить файлы
.clinerules/animation-gpu-properties.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы об animation-gpu-properties
Как установить animation-gpu-properties в Claude Code?
Сначала добавьте маркетплейс: /plugin marketplace add fcakyon/claude-codex-settings. Затем поставьте плагин: /plugin install react-skills@claude-settings. Файл правила лежит по пути .claude/rules/animation-gpu-properties.md.
Что делает animation-gpu-properties?
Запрещает анимировать width, height, top, left, margin и padding и показывает, как заменить такие анимации на transform и opacity без пересчёта layout.
Какие свойства можно анимировать без пересчёта layout?
transform с translate, scale или rotate и opacity. Остальные свойства правило считает причиной layout на каждом кадре.
Исходный текст
animation-gpu-properties.md · MIT
---
title: Animate Transform and Opacity Instead of Layout Properties
impact: HIGH
impactDescription: GPU-accelerated animations, no layout recalculation
tags: animation, performance, reanimated, transform, opacity
---
## Animate Transform and Opacity Instead of Layout Properties
Avoid animating `width`, `height`, `top`, `left`, `margin`, or `padding`. These trigger layout recalculation on every frame. Instead, use `transform` (scale, translate) and `opacity` which run on the GPU without triggering layout.
**Incorrect (animates height, triggers layout every frame):**
```tsx
import Animated, { useAnimatedStyle, withTiming } from 'react-native-reanimated'
function CollapsiblePanel({ expanded }: { expanded: boolean }) {
const animatedStyle = useAnimatedStyle(() => ({
height: withTiming(expanded ? 200 : 0), // triggers layout on every frame
overflow: 'hidden',
}))
return <Animated.View style={animatedStyle}>{children}</Animated.View>
}
```
**Correct (animates scaleY, GPU-accelerated):**
```tsx
import Animated, { useAnimatedStyle, withTiming } from 'react-native-reanimated'
function CollapsiblePanel({ expanded }: { expanded: boolean }) {
const animatedStyle = useAnimatedStyle(() => ({
transform: [
{ scaleY: withTiming(expanded ? 1 : 0) },
],
opacity: withTiming(expanded ? 1 : 0),
}))
return (
<Animated.View style={[{ height: 200, transformOrigin: 'top' }, animatedStyle]}>
{children}
</Animated.View>
)
}
```
**Correct (animates translateY for slide animations):**
```tsx
import Animated, { useAnimatedStyle, withTiming } from 'react-native-reanimated'
function SlideIn({ visible }: { visible: boolean }) {
const animatedStyle = useAnimatedStyle(() => ({
transform: [
{ translateY: withTiming(visible ? 0 : 100) },
],
opacity: withTiming(visible ? 1 : 0),
}))
return <Animated.View style={animatedStyle}>{children}</Animated.View>
}
```
GPU-accelerated properties: `transform` (translate, scale, rotate), `opacity`. Everything else triggers layout.
© fcakyon · MIT · fcakyon/claude-codex-settings