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

mobile-optimization — правило для Claude Code

Правило mobile-optimization с готовыми паттернами для ускорения Three.js-сцен на смартфонах и планшетах. Снижает нагрузку на GPU, уменьшает потребление памяти и помогает держать стабильный FPS.

MIT ★ 4 719 обновлён 2026-10-24

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

Что делает mobile-optimization

Правило собирает проверенные техники: обнаружение девайса и его мощности, оптимальная настройка рендерера (отключение антиалиасинга, ограничение pixelRatio до 1.5), выбор материалов от быстрых (MeshBasicMaterial) к медленным (MeshStandardMaterial). Включает примеры сжатия текстур через KTX2, объединения шейдеров в один для сокращения draw calls, агрессивной очистки памяти и использования LOD для сложных моделей.

Практический набор настроек покрывает тени (отключение, запечённые текстуры или BasicShadowMap), управление максимум 100 draw calls, рекомендации по размерам текстур (512–1024px для мобильных). Правило готово: просто скопируй блок кода нужного профиля (high, medium, low) в свой проект и адаптируй под сцену.

Опирается на iOS и Android. На слабых девайсах (≤4 ядер, <4 ГБ) материал Phong может упасть с 60 FPS до 15 — правило подсказывает, когда переходить на Lambert или Basic.

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

  • ускорить Three.js-сцену на мобильнике
  • снизить потребление видеопамяти и оперативной памяти
  • уменьшить количество draw calls ниже 100
  • выбрать подходящие материалы и текстуры по мощности девайса
  • оптимизировать постэффекты и тени для слабых GPU

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

  • Помогите оптимизировать Three.js-сцену для мобильных: включите обнаружение девайса и выберите профиль настроек
  • Покажите, как правильно настроить рендерер и материалы для iOS и Android
  • Сделайте импорт правила mobile-optimization в проект и примените его к текущей сцене

Как установить mobile-optimization

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

.claude/rules/mobile-optimization.md

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

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о mobile-optimization

Как установить mobile-optimization в Claude Code?

Скопируй файл mobile-optimization.md в папку .claude/rules/ проекта. После этого Claude Code будет учитывать рекомендации при работе с Three.js-кодом.

Что делает правило mobile-optimization?

Предоставляет набор готовых паттернов кода для оптимизации трёхмерных сцен на мобильных устройствах: от выбора материалов и сжатия текстур до управления памятью и снижения draw calls.

На каких девайсах работает и когда его применять?

Правило охватывает iOS и Android. Применяй его, если сцена тормозит на мобильнике, потребляет слишком много памяти или если нужно поддержать слабые девайсы с ≤4 ядрами и <4 ГБ памяти.

Исходный текст

mobile-optimization.md · MIT
# Mobile Optimization

Essential optimizations for Three.js on mobile devices.

## Device Detection

```javascript
const isMobile = /Android|iPhone|iPad|iPod/i.test(navigator.userAgent);
const isLowEnd = navigator.hardwareConcurrency <= 4;
const hasLimitedMemory = navigator.deviceMemory && navigator.deviceMemory < 4;
```

## Renderer Configuration

```javascript
const renderer = new THREE.WebGLRenderer({
  antialias: !isMobile,              // Disable AA on mobile
  powerPreference: 'high-performance',
  precision: isMobile ? 'mediump' : 'highp'
});

// Limit pixel ratio (CRITICAL)
renderer.setPixelRatio(Math.min(window.devicePixelRatio, isMobile ? 1.5 : 2));
```

## Material Hierarchy (Fast to Slow)

```javascript
// 1. MeshBasicMaterial (no lighting) - FASTEST
const basic = new THREE.MeshBasicMaterial({ color: 0xff0000 });

// 2. MeshLambertMaterial (per-vertex lighting)
const lambert = new THREE.MeshLambertMaterial({ color: 0xff0000 });

// 3. MeshPhongMaterial (per-pixel lighting)
const phong = new THREE.MeshPhongMaterial({ color: 0xff0000 });

// 4. MeshStandardMaterial (PBR) - SLOWEST
const standard = new THREE.MeshStandardMaterial({ color: 0xff0000 });
```

> On iOS, Phong can drop FPS from 60 to 15. Prefer Lambert or Basic for mobile.

## Texture Optimization

```javascript
// Max recommended: 1024x1024 for mobile, ideal: 512x512
texture.minFilter = THREE.LinearFilter; // Avoid mipmaps if not needed
texture.generateMipmaps = false;

// Use compressed formats - KTX2/Basis reduces memory 75%+
import { KTX2Loader } from 'three/addons/loaders/KTX2Loader.js';
const ktx2Loader = new KTX2Loader();
ktx2Loader.setTranscoderPath('/basis/');
ktx2Loader.detectSupport(renderer);
```

## Shader Optimization

### BAD - Multiple passes

```javascript
composer.addPass(bloomPass);
composer.addPass(filmPass);
composer.addPass(colorPass);
// 3 draw calls, 3 framebuffer switches
```

### GOOD - Combined SuperShader

```javascript
const superShader = {
  uniforms: { /* all uniforms combined */ },
  fragmentShader: `
    // Combine all effects in single shader
    void main() {
      vec4 color = texture2D(tDiffuse, vUv);
      color = applyBloom(color);
      color = applyFilm(color);
      color = applyColorGrade(color);
      gl_FragColor = color;
    }
  `
};
// 1 draw call, 1 framebuffer switch
```

## Memory Management

```javascript
// Pre-allocate everything at init
const tempVec3 = new THREE.Vector3();
const tempMatrix = new THREE.Matrix4();

// NEVER allocate in render loop
function animate() {
  // BAD: new THREE.Vector3() here
  // GOOD: tempVec3.set(x, y, z)
}

// Dispose aggressively
texture.dispose();
geometry.dispose();
material.dispose();

// Monitor memory
console.log(renderer.info.memory);
```

## Draw Calls

```javascript
// Check draw calls
console.log(renderer.info.render.calls);

// Target: < 100 draw calls on mobile

// Reduce with:
// - InstancedMesh for repeated objects
// - Merged geometries for static objects
// - Texture atlases
// - Material sharing
```

## Shadows on Mobile

```javascript
// Option 1: Disable shadows entirely
renderer.shadowMap.enabled = false;

// Option 2: Baked shadows (texture on ground plane)
const shadowTexture = textureLoader.load('baked-shadow.png');
const shadowMaterial = new THREE.MeshBasicMaterial({
  map: shadowTexture,
  transparent: true
});

// Option 3: Simple shadow map (if needed)
renderer.shadowMap.type = THREE.BasicShadowMap;
light.shadow.mapSize.set(512, 512); // Lower resolution
```

## Level of Detail

```javascript
const lod = new THREE.LOD();

// High detail (close)
lod.addLevel(highDetailMesh, 0);

// Medium detail
lod.addLevel(mediumDetailMesh, 10);

// Low detail (far)
lod.addLevel(lowDetailMesh, 30);

// Mobile distances
if (isMobile) {
  lod.levels[0].distance = 5;  // Switch sooner
  lod.levels[1].distance = 15;
}
```

## Mobile Checklist

- [ ] Pixel ratio ≤ 1.5
- [ ] Textures ≤ 1024px
- [ ] No antialiasing (or FXAA)
- [ ] Simple materials (Basic/Lambert)
- [ ] Post-processing minimal or combined
- [ ] Dispose aggressively
- [ ] Draw calls < 100
- [ ] No shadows or baked shadows
- [ ] LOD for complex models
- [ ] Precision mediump

## Performance Profiles

```javascript
const profiles = {
  high: {
    pixelRatio: 2,
    textureSize: 2048,
    shadows: true,
    postprocessing: true,
    antialias: true
  },
  medium: {
    pixelRatio: 1.5,
    textureSize: 1024,
    shadows: true,
    postprocessing: false,
    antialias: false
  },
  low: {
    pixelRatio: 1,
    textureSize: 512,
    shadows: false,
    postprocessing: false,
    antialias: false
  }
};

const profile = isMobile ?
  (isLowEnd ? profiles.low : profiles.medium) :
  profiles.high;

applyProfile(profile);
```

## Touch Controls

```javascript
// OrbitControls works on touch by default
const controls = new OrbitControls(camera, renderer.domElement);
controls.enableDamping = true;

// Disable zoom pinch if needed
controls.enableZoom = false;

// Touch-friendly hit areas
// Make interactive elements at least 44x44 CSS pixels
```

## References

- [Three.js Mobile Optimization](https://threejs.org/manual/#en/optimize-lots-of-objects)
- [WebGL Best Practices](https://developer.mozilla.org/en-US/docs/Web/API/WebGL_API/WebGL_best_practices)

© zebbern · MIT · zebbern/claude-code-guide

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

Все правила IDE по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
build-mobile-threejs-games MengTo Скилл build-mobile-threejs-games для сборки и проверки Three.js-игры под мобильный веб: тач-управление, адаптивный HUD, бюджеты производительности. CX Codex +1 1 600установок scenario-unity-mobile scenario-labs Скилл scenario-unity-mobile для Claude Code ведёт мобильную сборку Unity 6.3: проверяет FPS, текстуры ASTC, URP для Android и iOS, подпись AAB и IAP. Разбирает лаги игры на телефоне. CX Codex +1 562установок godot-platform-mobile thedivergentai Скилл godot-platform-mobile для Claude Code и пяти других платформ, который даёт агенту экспертный контекст по мобильной разработке на Godot: тач-ввод, безопасные зоны экрана, оптимизация батареи, публикация в магазины. CX Codex +1 518установок mobile-game-dev omer-metin Скилл mobile-game-dev помогает агенту разрабатывать мобильные игры с учётом сенсорного ввода, батареи, нагрева и различий между устройствами iOS и Android. CX Codex +1 226установок mobile-touch dylantarre Скилл mobile-touch для Claude Code, который помогает проектировать жесты, хаптику и анимации в iOS и Android. Раскладывает 12 принципов анимации Диснея по мобильным сценариям с конкретными реализациями, таймингами и гайдом по хаптике. CX Codex +1 2 500установок imagegen-frontend-mobile nexu-io Скилл imagegen-frontend-mobile генерирует premium mobile-экраны и флоу для iOS, Android и кросс-платформы с чистой иерархией, читаемым текстом и контролируемой палитрой. CX Codex +1 1 900установок

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

Весь набор →
animation-system Правило animation-system объясняет систему анимации Three.js: от запуска и смешивания клипов до морфинга и управления костями. Пригодится при работе с анимированными 3D-моделями. CX Codex +1 ★ 4 719звёзд репо gltf-loading-optimization Правило gltf-loading-optimization для Claude Code содержит сниппеты и команды для загрузки glTF в Three.js, настройки декодеров, прогресса, ленивой подгрузки и сжатия моделей. CX Codex +1 ★ 4 719звёзд репо physics-integration Правило physics-integration задаёт правила связки Three.js с физическими движками Rapier и Cannon-es: настройка Vite, коллайдеры и синхронизация позиций. CX Codex +1 ★ 4 719звёзд репо raycasting-optimization Правило raycasting-optimization для Claude Code описывает, как ускорить поиск пересечений и выбор объектов в Three.js. Сокращает проверки Raycaster в интерактивных сценах и на сложных мешах. CX Codex +1 ★ 4 719звёзд репо webxr-setup Правило webxr-setup для Claude Code задаёт настройку VR- и AR-сцен на Three.js через WebXR. Помогает агенту настроить рендерер, контроллеры и отслеживание рук. CX Codex +1 ★ 4 719звёзд репо error-handling-recovery Правило error-handling-recovery для Claude Code обрабатывает потерю WebGL-контекста, пересоздаёт ресурсы и показывает запасной интерфейс в Three.js-сценах. CX Codex +1 ★ 4 719звёзд репо vc-industry-research Скилл vc-industry-research собирает отраслевое исследование в стиле PE/VC: глубокий разбор сектора, инвестиционный меморандум или обзор рынка. На китайском или английском, по умолчанию в PDF. CX Codex +1 ★ 4 719звёзд репо tsl-complete-reference Правило tsl-complete-reference для Claude Code даёт справочник по TSL и помогает писать нодовые шейдеры без ошибок в типах и вызовах. CX Codex +1 ★ 4 719звёзд репо

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

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