Communitygithub.com

steipete/swiftui-liquid-glass

SwiftUI Liquid Glass: implementar, adotar, refatorar, revisar corretude/desempenho/design.

O que é swiftui-liquid-glass?

Esta skill capacita desenvolvedores a implementar, revisar e refatorar recursos SwiftUI que utilizam a API Liquid Glass do iOS 26+. Ela fornece diretrizes para substituir efeitos de desfoque customizados pelas APIs nativas como `glassEffect`, `GlassEffectContainer` e estilos de botão vidro, garantindo um visual consistente e interativo quando necessário. A skill inclui árvores de decisão para diferentes cenários (revisão, melhoria ou implementação de novos recursos), listas de verificação de disponibilidade, ordem de modificadores e uso de transições morfológicas. Exemplos práticos de código Swift mostram como usar `glassEffect` com fallback para versões anteriores do iOS, e como agrupar múltiplos elementos vítreos em `GlassEffectContainer`. A skill é útil para quem deseja adotar o Liquid Glass de acordo com as práticas recomendadas pela Apple, com foco em desempenho e design coeso, e é aplicável tanto na criação de novos componentes quanto na revisão de código existente.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/swiftui-liquid-glass

Perguntar na sua IA favorita

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

Documentação

SwiftUI Liquid Glass

Atribuição: copiado de Dimillian/Skills de @Dimillian (2025-12-31).

Visão Geral

Use esta skill para construir ou revisar recursos SwiftUI que estejam totalmente alinhados com a API Liquid Glass do iOS 26+. Priorize APIs nativas (glassEffect, GlassEffectContainer, estilos de botão vítreo) e as diretrizes de design da Apple. Mantenha o uso consistente, interativo quando necessário e com atenção ao desempenho.

Árvore de Decisão do Fluxo de Trabalho

Escolha o caminho que corresponde à solicitação:

1) Revisar um recurso existente

  • Inspecione onde o Liquid Glass deve ser usado e onde não deve.
  • Verifique a ordem correta dos modificadores, o uso de formas e o posicionamento dos contêineres.
  • Verifique o tratamento de disponibilidade para iOS 26+ e fallbacks sensíveis.

2) Melhorar um recurso usando Liquid Glass

  • Identifique componentes alvo para o tratamento vítreo (superfícies, chips, botões, cartões).
  • Refatore para usar GlassEffectContainer onde múltiplos elementos vítreos aparecem.
  • Introduza vidro interativo apenas para elementos tocáveis ou focáveis.

3) Implementar um novo recurso usando Liquid Glass

  • Projete as superfícies vítreas e as interações primeiro (forma, proeminência, agrupamento).
  • Adicione modificadores vítreos após os modificadores de layout e aparência.
  • Adicione transições morfológicas apenas quando a hierarquia de visualização mudar com animação.

Diretrizes Principais

  • Prefira APIs nativas do Liquid Glass em vez de desfoques customizados.
  • Use GlassEffectContainer quando múltiplos elementos vítreos coexistem.
  • Aplique .glassEffect(...) após modificadores de layout e visuais.
  • Use .interactive() para elementos que respondem ao toque/ponteiro.
  • Mantenha as formas consistentes entre os elementos relacionados para uma aparência coesa.
  • Proteja com #available(iOS 26, *) e forneça um fallback não vítreo.

Lista de Verificação de Revisão

  • Disponibilidade: #available(iOS 26, *) presente com UI de fallback.
  • Composição: Múltiplas visualizações vítreas envolvidas em GlassEffectContainer.
  • Ordem dos modificadores: glassEffect aplicado após modificadores de layout e aparência.
  • Interatividade: interactive() apenas onde existe interação do usuário.
  • Transições: glassEffectID usado com @Namespace para morfismo.
  • Consistência: Formas, matizes e espaçamento alinhados em todo o recurso.

Lista de Verificação de Implementação

  • Defina os elementos alvo e a proeminência vítrea desejada.
  • Envolva elementos vítreos agrupados em GlassEffectContainer e ajuste o espaçamento.
  • Use .glassEffect(.regular.tint(...).interactive(), in: .rect(cornerRadius: ...)) conforme necessário.
  • Use .buttonStyle(.glass) / .buttonStyle(.glassProminent) para ações.
  • Adicione transições morfológicas com glassEffectID quando a hierarquia mudar.
  • Forneça materiais e visuais de fallback para versões anteriores do iOS.

Snippets Rápidos

Use estes padrões diretamente e adapte formas, matizes e espaçamento.

if #available(iOS 26, *) {
    Text("Hello")
        .padding()
        .glassEffect(.regular.interactive(), in: .rect(cornerRadius: 16))
} else {
    Text("Hello")
        .padding()
        .background(.ultraThinMaterial, in: RoundedRectangle(cornerRadius: 16))
}
GlassEffectContainer(spacing: 24) {
    HStack(spacing: 24) {
        Image(systemName: "scribble.variable")
            .frame(width: 72, height: 72)
            .font(.system(size: 32))
            .glassEffect()
        Image(systemName: "eraser.fill")
            .frame(width: 72, height: 72)
            .font(.system(size: 32))
            .glassEffect()
    }
}
Button("Confirm") { }
    .buttonStyle(.glassProminent)

Recursos

  • Guia de referência: references/liquid-glass.md
  • Prefira a documentação da Apple para detalhes atualizados da API.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

Habilidades Relacionadas