Communitygithub.com

HashBrake/apple-hardware-design

A linguagem de design industrial da Apple traduzida em regras concretas para CAD de hardware e robótica — forma, cantos de curvatura contínua, arestas, emendas e folgas, CMF, aberturas de ventilação, controles, luzes de status, docks, mecanismos, movimento de robôs e renders no estilo Apple. Use quando o objetivo for estética ou artesanato premium — "faça parecer que a Apple projetou", estilo Apple, Jony Ive, unibody, squircle / canto contínuo / filete G2, gabinete premium, reformulação ou revisão de design de um robô ou produto a partir de uma captura de tela CAD, render, STEP.

O que é apple-hardware-design?

Este skill fornece uma sistematização abrangente da linguagem de design industrial da Apple, destinada a engenheiros e designers que trabalham com CAD em robótica e hardware. Ele integra décadas de práticas documentadas — desde os desenhos dimensionais da Apple e as Diretrizes de Design de Acessórios até relatórios ambientais, artigos sobre movimento de robôs da Apple ML Research e teardowns. O conteúdo aborda desde princípios fundamentais (como a "inevitabilidade" do design e a redução antes do refinamento) até especificações técnicas concretas: cantos de curvatura contínua (G2/G3), famílias de arestas, emendas e folgas, materiais e acabamentos (CMF). O skill suporta múltiplos modos de uso: 'Design' (gera uma especificação completa antes do CAD), 'Fast Path' (responde perguntas diretas com números e regras) e 'Review' (avalia renders ou descrições com uma checklist de pontuação). Inclui scripts para gerar cantos contínuos no estilo Apple em plataformas como CadQuery, build123d, SolidWorks, Fusion e Onshape. A ênfase está em criar objetos que pareçam uma única peça, com simplicidade resolvida, proporções racionais e cuidado proporcional ao toque humano, respeitando sempre as normas de segurança (ISO 13850, IEC 60204-1) que devem prevalecer sobre a estética. O skill é compatível com as principais ferramentas CAD (SolidWorks, Fusion, Onshape, CadQuery, build123d, OpenSCAD e FeatureScript) e oferece métodos verificados para garantir curvatura contínua e exportação STEP limpa.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/HashBrake/apple-hardware-design/tree/HEAD/skills/apple-hardware-design

Perguntar na sua IA favorita

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

Documentação

Apple Hardware Design

Como a equipe de Design Industrial da Apple faz os objetos parecerem inevitáveis, destilado a partir dos desenhos dimensionais oficiais da Apple para fabricantes de cases, das Diretrizes de Design de Acessórios (R32, outubro de 2026), do HIG, dos relatórios ambientais da Apple, dos artigos sobre movimento de robôs da Apple ML Research, das patentes da Apple, de teardowns e de vinte e cinco anos de entrevistas de Ive/Apple. Tudo aqui é traduzido para quem constrói robôs e outros hardwares em CAD.

A linha condutora: um objeto da Apple é lido como uma coisa só. É um primitivo único feito de um material honesto, e seu processo de fabricação determina sua forma. Toda superfície visível tem curvatura contínua, toda emenda é deliberada e cada detalhe recebe cuidado na proporção de quantas vezes uma mão o toca. Tudo o que não é a função do produto foi removido ou está oculto até ser necessário.

"Tentamos desenvolver produtos que pareçam, de alguma forma, inevitáveis." — Jony Ive

"Só porque algo é despojado não significa que seja bom. Pode ser frio, pode ser sem alma." — Ive, 2025

Como trabalhar

Escolha o modo a partir da solicitação:

  • Modo Design ("projetar / reformular / tornar isto parecido com Apple"). Produza uma especificação de design antes de qualquer CAD. A especificação cobre:

    • o primitivo e as proporções
    • a família de arestas e os valores dos raios
    • o mapa de emendas
    • CMF, incluindo o processo de fabricação para cada parte visível
    • controles, luzes e docking
    • estratégia de serviço

    Em seguida, forneça os passos CAD ou o código. Ofereça 3–5 variantes paramétricas da proporção chave e diga qual você escolheria e por quê (a Apple constrói protótipos a cada 0,1" e convive com eles).

  • Caminho rápido (uma solicitação restrita: "arredondar esta tampa", "qual raio aqui", "cor para esta peça"). Responda diretamente com o número, a opção CAD e a única regra por trás dela. Sem especificação, sem variantes, a menos que o usuário peça mais.

  • Modo Revisão (uma captura de tela, render, STEP ou descrição). Execute a Checklist de Revisão no final. Atribua a cada item uma pontuação de 0 a 2 e marque os itens N/A. Relate a pontuação como uma porcentagem dos itens aplicáveis. Liste as correções classificadas por impacto visual, cada uma com um número concreto ("planejar canto R8 arco tangente → canto contínuo, R_core 14, extensão 19 mm").

    • A partir de um único render ou captura de tela:
      • Estime raios e folgas escalando em relação a uma dimensão conhecida (tamanho geral, uma porta USB-C 8,4 × 2,6 mm, uma cabeça de parafuso) e diga que são estimativas.
      • Julgue a continuidade pelos realces. Um realce que quebra ou muda de largura onde um filete encontra uma superfície plana indica G1.
      • Em seguida, peça as evidências que resolvem o resto: listras zebra em cada transição herói, um pente de curvatura na seção principal, uma vista superior e um render 3/4 com softbox gradiente (references/cad-workflow.md §2).
  • Modo Código (CadQuery / build123d / OpenSCAD / FeatureScript). Use scripts/apple_corner.py para contornos em planta. Siga as soluções alternativas do kernel em references/cad-workflow.md §1, porque os filetes do OCC são apenas G1.

Sempre nomeie a opção real da ferramenta CAD ("SolidWorks Fillet → Curvatura contínua", "Fusion Continuidade: G2 + Cantos com recuo", "Onshape seção transversal: Curvatura"). Se o usuário não disse qual ferramenta, pergunte ou forneça as opções para todas as três.

A segurança e as normas substituem a estética. Projete-as lindamente; nunca as projete para fora. Veja §21 para a lista completa. A versão resumida:

  • As paradas de emergência seguem a ISO 13850 / IEC 60204-1: atuador vermelho sobre fundo amarelo, acessível, nunca oculto.
  • Placas de identificação exigidas, etiquetas de aviso e luzes de aviso permanecem visíveis.
  • Proteção contra pinçamento e cisalhamento, temperatura de toque, vedação IP e desempenho de RF vêm em primeiro lugar.

1. Inevitabilidade: reduza antes de refinar

  • O teste: toda superfície, linha, recurso e cor precisa de uma razão funcional ou de fabricação. Se precisar de uma história para justificá-lo, delete-o.
  • Um gesto herói por produto. Corte portas, LEDs, cores, texturas e linhas de peça até que remover mais uma quebraria o produto. Foco é "dizer não a algo que, com todos os ossos do seu corpo, você acha que é uma ideia fenomenal."
  • Simplicidade significa complexidade resolvida, não uma caixa em branco. Consolide peças e funções; não as esconda atrás de uma tampa maior. Uma laje fria e sem características é o modo de falha.
  • Arquétipos familiares vencem ficção científica.
    • A pesquisa de robôs da Apple escolheu um abajur porque as pessoas já leem uma cabeça, um pescoço e um olhar nele.
    • O Watch foi concebido para ser "estranhamente familiar."
    • Evite teatralidade de "rosto de robô", espetáculo de cromo e LED e brilho automotivo.
  • Faça o cuidado onde as mãos vão. Ive dedicou esforço a uma aba de puxar da embalagem porque "milhões de pessoas interagiriam com esta pequena aba." Em um robô, os pontos de contato são:
    • a alça ou ponto de içamento
    • a parada de emergência
    • a interface do dock
    • a escotilha de serviço
    • as almofadas do gripper
    • o primeiro toque ao sair da caixa

2. Primitivo e proporção

  • Reduza cada módulo principal a um primitivo dominante: uma laje quadrada (Mac mini, Studio, Apple TV), um cilindro (Mac Pro 2013, HomePod), uma esfera truncada (HomePod mini), uma cúpula (base do iMac G4, HomeView) ou um disco (AirTag, MagSafe). Os recursos são cortados ou incrustados nesse volume, nunca aparafusados como bosses.

  • Use proporções inteiras simples, não φ. A história da proporção áurea é um mito desmascarado. As proporções reais da Apple:

    ProdutoAltura : lado
    Apple TV1 : 3 (93,24² × 31,00 mm)
    Mac mini2 : 5 (127² × 50)
    Mac Studio≈ 1 : 2 (197² × 95)

    Pegadas quadradas são comuns.

  • Simetria e eixos compartilhados. Centralize os recursos nos eixos primários. Furos, botões e lentes compartilham uma linha central ou uma tangente, e seus passos se repetem (a grade da câmera do iPhone 16 Pro usa 3 × 16,20, 2 × 8,85 mm). As margens até a borda são iguais. Centralize matematicamente, depois desloque opticamente onde parecer errado.

  • A massa permanece baixa; a carga útil permanece leve. O iMac G4 tem uma cúpula pesada carregando a eletrônica e um braço brilhante, fino e contrabalançado segurando uma tela leve. Esta é a forma Apple mais relevante para robótica.

  • Concentre a espessura em um lugar honesto. O iPhone Air coloca toda a sua profundidade em um platô de largura total para que todo o resto possa ter 5,64 mm de espessura. O volume de um robô (computação, bateria, atuadores) deve viver em um volume deliberado, não espalhado como protuberâncias.

3. Cantos: curvatura contínua, nunca um filete simples

A Apple dimensiona cada pequeno recurso como um raio, mas o canto do corpo é dado como uma tabela de pontos spline em seus próprios desenhos. É deliberadamente não um arco. Um arco tangente (G1) salta de 0 para 1/R de curvatura, o que se mostra como uma quebra de realce. Ive chamou essas de "quebras de tangência não resolvidas."

  • G2 ou melhor em toda transição de superfície A pela qual a luz possa passar. G1 é aceitável apenas para quebras abaixo de ~0,3 mm ou em superfícies ocultas.

  • Medido a partir dos desenhos da Apple: a curvatura aumenta de zero até seu ponto mais apertado no ápice de 45°, e depois diminui.

    • Esse raio do ápice é o raio visual R que você lê a olho nu.
    • Extensão E ≈ 1,41 × R (E é a distância do canto virtual afiado até onde a curva deixa o plano; a faixa medida é 1,35–1,5, e o iPhone opera mais apertado em ≈1,2).
    • Ele se ajusta a uma exata Bézier quíntica por canto, dentro de 0,28% de E (veja o script).
    • A suavização "iOS" do Figma (60%) parece próxima, mas ultrapassa sua curvatura em ~25%.
  • Tamanho do canto por objeto:

    ObjetoR_core
    Segurado na mão≈ 25% do lado curto
    Objeto de mesa≈ 20%
    Painel plano grande (tipo iPad)≈ 8%
  • Não use uma superelipse para todo o contorno. Ela não tem planos verdadeiros, e os produtos Apple têm planos longos e verdadeiros. Cantos superelípticos unidos a linhas são G2, mas são mais longos que os da Apple (E/R ≈ 1,8 em n=3, 2,5 em n=4, 3,3 em n=5, contra 1,41 da Apple). Não aumente n pensando que é "mais Apple".

  • Gere-o:

    python3 scripts/apple_corner.py --w 120 --h 80 --r 16 --fmt build123d   # ou cadquery
    python3 scripts/apple_corner.py --w 120 --h 80 --r 16 --fmt ctrl        # pontos de controle para CAD interativo
    python3 scripts/apple_corner.py --w 120 --h 80 --r 16 --fmt check       # veredito G1/G2 (tente --model arc para comparar)
    python3 scripts/apple_corner.py --w 120 --h 80 --r 16 --offset 3 --fmt csv   # contorno interno concêntrico
    
    • Cada canto é uma Bézier exata de grau 5. Seus três primeiros pontos de controle estão em um plano e os três últimos no outro, de modo que a junta tem curvatura zero: G2 por construção.
    • A saída build123d / cadquery são 4 Lines mais 4 Beziers. Foi testada no OCC: o sólido é válido, a curvatura é zero nas juntas, não há inflexões e o ápice atinge exatamente o R solicitado. Exporta STEP limpo.
    • CAD interativo: use --fmt ctrl e desenhe cada canto como uma spline de pontos de controle de grau 5 através dos 6 pontos. Em seguida, una os cantos com linhas.
      • SolidWorks: Style Spline → Bézier, grau 5.
      • Fusion: Control Point Spline, grau 5.
      • Onshape: Control point spline, grau 5.
    • Nunca ajuste uma spline através de todo o contorno: você perde os planos verdadeiros.
    • Verifique com listras zebra.
    • Deslocamentos concêntricos devem permanecer abaixo do R visual, ou o canto interno cria cúspides. Para um encaixe maior, gere um novo canto menor.

4. Arestas: uma família, um tamanho

Escolha UMA família de arestas para todo o produto.

FamíliaPrecedente AppleReceitaQuando
Banda plana + rolo G2 (padrão)iPhone 12–17, iPad ProO lado tem 40–60% de plano verdadeiro, depois um rolo G2 de R ≈ 0,25–0,35 × espessura (iPhone 16: plano ±1,62 de 7,81 mm, rolo R ≈ 1,8–2,8)Preciso, moderno
AlmofadadoiPhone 6–11, AirPods, HomePod miniSeção contínua G2/G3, sem planos lateraisAmigável, segurado na mão, macio
Quebra suave em laje usinadaMacBook, Mac mini, StudioGrandes planos, quebra uniforme de 0,3–1,0 mmCascas de metal usinado
Plano + chanfro diamantadoiPhone 5Chanfro brilhante de 45° de 0,3–0,6 mm em corpo fosco; idêntico em todo o perímetroUma linha de joia em alumínio anodizado
Afunilado / fio de facaCunha do MacBook AirEspessura variaSó se o afunilamento esconder espessura real (a Apple abandonou isso em 2022)
  • Dê a cada quebra visível o mesmo tamanho. Nunca misture uma tampa chanfrada com laterais almofadadas.
  • Grandes faces são verdadeiramente planas. A Apple não coroa painéis; toda a suavidade vive nas transições de borda.
  • Nenhuma borda anodizada mais afiada que R0,3 / C0,2 (R0,5 preferido). No iPhone 17 Pro, bordas de platô afiadas lascaram ("scratchgate"). Bordas manuseadas e aterradas recebem mais raio. Superfícies de robô que podem tocar pessoas precisam de raios ainda maiores (veja §21, ISO/TS 15066).

5. Concentricidade

  • R_interno = R_externo − deslocamento, compartilhando um centro. Para cantos contínuos, desloque toda a curva em vez de escolher um novo raio. Isso se aplica a:
    • janelas de exibição e sensor na casca
    • tampas de botões em seus bolsos
    • tampas em molduras
    • campos de perfuração em painéis
    • protetores de junta em torno de eixos
  • Se R_externo − deslocamento ≤ 0, encolha o canto interno para uma pequena quebra ou alargue a borda. Nunca escolha um raio arbitrário.
  • O sistema de design de 2025 da Apple formaliza três tipos de forma (fixa, cápsula = altura/2, concêntrica) e alerta contra cantos que pareçam "apertados ou alargados."

6. Emendas, folgas, nivelamento

  • As linhas de partição são linhas projetadas. Coloque-as em um eixo primário, simétricas, com largura constante e alinhadas a outros recursos. Coloque-as em uma mudança de material ou direção (vidro→metal, rolo→plano, uma borda tangente). Nunca no meio da face, nunca no meio do filete. As linhas de antena do iPhone são simétricas, com cor combinada e honestas.

  • Minimize o número de peças. Um unibody ou extrusão onde as cargas permitirem. O unibody da Apple substituiu muitas peças "por apenas uma peça."

  • Metas (a Apple não publica nenhuma; estas são práticas de CE premium):

    ItemUsinadoMoldado
    Folga visível0,10–0,20 mm0,15–0,30 mm
    Variação da folga≤ ±0,05≤ ±0,05
    Nivelamento±0,05±0,10
    Botão saliente0,3–0,6 mm, mesma quebra de borda que o corpomesmo
  • Faça nivelado, ou faça um degrau deliberado (≥ 0,5 mm, ou um encaixe projetado de 0,3–0,6 mm de largura). Nunca 0,1 mm "quase nivelado."

  • A Apple classificou os painéis traseiros do iPhone 5 em 725 tamanhos e os combinou por câmera. Folgas uniformes são um sistema de fabricação, não uma esperança. Posicione cada casca a partir do chassi interno e faça as cascas flutuarem em um pino mais uma ranhura. Verifique a pilha de cada folga visível.

  • Escale as folgas com tamanho, temperatura e carga. Números em escala de telefone não sobrevivem em uma casca de robô de 300–800 mm: o alumínio cresce ≈0,46 mm em 500 mm a ΔT 40 K, e os elos flexionam sob carga.

    • Orce cada folga a partir de uma pilha de tolerância, crescimento térmico e deflexão. Um ponto de partida útil é 0,2 mm + 0,5 mm por metro de comprimento do painel (prática).
    • Em costuras longas, prefira um encaixe projetado (0,5–1,0 mm), que esconde essa variação, a uma linha fina que roça e clica.

7. O material é a estrutura (CMF)

  • Um material primário, usado estruturalmente. A casca é o chassi, o dissipador de calor e, frequentemente, o plano de terra da antena. Exemplos:

    • iPhone 17 Pro: unibody forjado em alumínio série 7000 com uma câmara de vapor soldada a laser internamente.
    • Mac Pro: uma estrutura de aço inoxidável cujas alças polidas e pés são a estrutura.

    Não coloque uma pele cosmética sobre uma estrutura separada.

  • Verdade aos materiais. Alumínio usinado parece usinado; plástico parece bom plástico (Apple: o iPhone 5c era "desavergonhadamente plástico"). Nunca pinte plástico para fingir metal. Sem aberturas falsas, parafusos falsos, decalques ou texturas falsas.

  • A física escolhe o material. A Apple trocou titânio por alumínio no 17 Pro por questões térmicas e de peso. Titânio é um sinal premium para peças pequenas e de alto toque, não um padrão.

  • Acabamento padrão:

    • Jateamento fino com esferas (vidro/zircônia, ≈100–170 mesh) mais MIL-A-8625 Tipo II anodização, 10–15 µm.
    • Cetim, Ra ≈ 0,4–1,0 µm.
    • Anodize todas as peças de encaixe em um único lote.
  • Destaques:

    • Uma "joia" polida por produto: uma alça, um chanfro, um logotipo ou um anel de lente. Um chanfro diamantado é cortado após a anodização e, opcionalmente, reanodizado em claro.
    • Aço polido

…

[truncado para tradução]

Habilidades Relacionadas