Communitygithub.com

site-3d-premium

Diretrizes para criação de sites 3D premium, com foco em shaders WebGL personalizados, pós-processamento, interações físicas, animações suaves, pré-carregadores e otimização para dispositivos.

O que é site-3d-premium?

Este guia fornece padrões arquiteturais e de código para desenvolver sites 3D de alto padrão, voltados para desenvolvedores que desejam implementar efeitos visuais WebGL avançados, pipelines de shaders personalizados, elementos de física interativa e transições de página imersivas, mantendo alta performance. Ele cobre o uso de Three.js, React Three Fiber (R3F) e Spline com shaders GLSL, além de efeitos de pós-processamento como bloom, profundidade de campo e granulação de filme. Também aborda estratégias de otimização, incluindo carregamento de ativos com pré-carregadores interativos, compressão de modelos 3D (Draco) e limitação da proporção de pixels para dispositivos de alta resolução. O conteúdo é prático, com exemplos de código e boas práticas para evitar problemas comuns, como quedas de quadros em dispositivos móveis ou longos tempos de carregamento.

Funciona com✓Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/AbbasMalikzada/agent-skills/tree/HEAD/skills/premium-3d-website

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Site 3D Premium

Visão Geral

Esta skill fornece diretrizes arquiteturais e padrões de código para desenvolver sites 3D premium e de alto nível. Ela é direcionada a desenvolvedores que desejam implementar efeitos visuais WebGL avançados, pipelines de shaders personalizados, elementos de física interativa e transições de página imersivas, mantendo alta performance.

Quando Usar Esta Skill

  • Use ao projetar sites criativos premium ou premiados com elementos 3D.
  • Use ao integrar Three.js, React Three Fiber (R3F) ou Spline com shaders personalizados (GLSL).
  • Use ao implementar efeitos de pós-processamento como bloom, profundidade de campo ou granulação de filme personalizada.
  • Use ao projetar pré-carregadores interativos e estratégias de carregamento de ativos de alta performance.
  • Use ao otimizar cenas 3D complexas para responsividade e desempenho em dispositivos móveis.

Como Funciona

Passo 1: Estabelecer o Loop de Renderização e a Arquitetura da Cena

Configurar um contexto WebGL robusto com tratamento adequado de redimensionamento e proporções de pixels otimizadas é crucial. Mantenha as proporções de pixels limitadas a um máximo de 2 para evitar renderizar muitos pixels em telas de alta densidade.

Passo 2: Implementar Efeitos de Shader e Pós-Processamento

Incorpore pipelines de pós-processamento (usando EffectComposer ou @react-three/postprocessing) para adicionar bloom, aberração cromática, profundidade de campo ou granulação de filme. Mantenha o número de passes baixo e combine fragment shaders personalizados para minimizar chamadas de desenho.

Passo 3: Integrar Física Interativa e Movimento

Utilize frameworks de física (como Cannon.js ou Rapier) ou animações de mola procedurais para fazer objetos 3D reagirem a entradas de mouse, como hover, arrastar e clicar, com feedback orgânico.

Passo 4: Pipeline de Ativos e Pré-Carregador

Otimize modelos 3D (usando compressão Draco) e carregue-os usando gerenciadores de carregamento personalizados. Renderize pré-carregadores interativos para entreter os usuários enquanto ativos pesados são baixados em segundo plano.

Exemplos

Exemplo 1: Pós-processamento Personalizado no React Three Fiber (R3F)

import { Canvas } from '@react-three/fiber';
import { EffectComposer, Bloom, DepthOfField, Vignette } from '@react-three/postprocessing';

export default function PremiumComposer() {
  return (
    <Canvas dpr={[1, 2]} gl={{ powerPreference: "high-performance", antialias: false }}>
      <ambientLight intensity={0.5} />
      <mesh>
        <boxGeometry />
        <meshStandardMaterial emissive="orange" emissiveIntensity={2.0} />
      </mesh>
      
      <EffectComposer disableNormalPass>
        <DepthOfField focusDistance={0} focalLength={0.02} bokehScale={2} height={480} />
        <Bloom luminanceThreshold={0.3} luminanceSmoothing={0.9} height={300} />
        <Vignette eskil={false} offset={0.1} darkness={1.1} />
      </EffectComposer>
    </Canvas>
  );
}

Exemplo 2: Material Shader GLSL Personalizado para Efeitos Líquidos/Ondulados

import * as THREE from 'three';

const CustomWavyMaterial = new THREE.ShaderMaterial({
  vertexShader: `
    varying vec2 vUv;
    uniform float uTime;
    void main() {
      vUv = uv;
      vec3 pos = position;
      pos.z += sin(pos.x * 5.0 + uTime) * 0.1;
      pos.z += cos(pos.y * 5.0 + uTime) * 0.1;
      gl_Position = projectionMatrix * modelViewMatrix * vec4(pos, 1.0);
    }
  `,
  fragmentShader: `
    varying vec2 vUv;
    uniform float uTime;
    uniform vec3 uColor;
    void main() {
      float pulse = 0.5 + 0.5 * sin(uTime + vUv.x * 10.0);
      gl_FragColor = vec4(uColor * pulse, 1.0);
    }
  `,
  uniforms: {
    uTime: { value: 0.0 },
    uColor: { value: new THREE.Color('#3b82f6') }
  }
});

Melhores Práticas

  • ✅ Defina dpr={[1, 2]} para restringir a proporção de pixels do dispositivo a um máximo de 2.
  • ✅ Desative o antialiasing no WebGLRenderer quando o pós-processamento estiver ativo para evitar penalidades de desempenho por anti-aliasing duplicado.
  • ✅ Pré-calcule oclusão ambiente, iluminação e sombras em texturas usando Blender ou outros softwares 3D, em vez de usar luzes dinâmicas e sombras em tempo real.
  • ✅ Use renderização por instância (THREE.InstancedMesh ou R3F <Instances>) para cenas que contenham múltiplas malhas idênticas.
  • ❌ Evite usar modelos GLTF/OBJ não comprimidos. Sempre comprima modelos usando Draco ou Meshopt.
  • ❌ Evite mapas de sombra em tempo real (como THREE.DirectionalLightShadow) em dispositivos móveis ou de baixo desempenho devido ao alto custo de processamento.

Limitações

  • Esta skill não substitui validação, testes ou revisão especializada específicos do ambiente.
  • Pare e peça esclarecimentos se as entradas, permissões ou limites de segurança necessários estiverem ausentes.
  • Matemática de shader complexa e limites de simulação física avançada exigem testes manuais em diferentes chipsets de dispositivos.

Notas de Segurança e Proteção

  • Verifique se as URLs de modelos 3D externos (carregados via GLTFLoader) estão hospedadas em CDNs confiáveis e seguras (HTTPS).
  • Não execute scripts de shell arbitrários e não validados nem use pacotes NPM não fixados para otimizar ativos.

Armadilhas Comuns

  • Problema: Queda severa de quadros/lag em telas móveis ou Retina de alta densidade. Solução: Garanta que a proporção de pixels seja limitada a 2 (renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2))) e desative passes de pós-processamento não utilizados.
  • Problema: Longos tempos de carregamento e telas brancas durante a inicialização. Solução: Use um gerenciador de carregamento (THREE.LoadingManager) e exiba um pré-carregador interativo responsivo para manter o usuário engajado.

Skills Relacionadas

  • @3d-web-experience - Conceitos centrais de WebGL, Three.js e Spline.
  • @scroll-experience - Integração de animação 3D com controladores de rolagem.
  • @performance-optimizer - Ajuste geral de desempenho de execução de código.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas