Communitygithub.com

steipete/swiftui-liquid-glass

Implementar, adaptar, refactorizar y revisar la corrección/rendimiento/diseño de SwiftUI Liquid Glass.

¿Qué es swiftui-liquid-glass?

Esta habilidad está diseñada para desarrolladores que trabajan con SwiftUI y la API nativa Liquid Glass de iOS 26+. Proporciona directrices y listas de verificación para implementar, refactorizar, revisar o crear nuevas características que utilicen esta API. La habilidad enfatiza el uso de APIs nativas como `glassEffect`, `GlassEffectContainer` y estilos de botón de vidrio, asegurando consistencia, interactividad adecuada y rendimiento. Incluye un árbol de decisión para elegir el flujo de trabajo correcto (revisar, mejorar o implementar), listas de verificación detalladas para la revisión de código, y fragmentos de código Swift listos para usar. También cubre la gestión de disponibilidad (`#available(iOS 26, *)`) y la provisión de fallbacks para versiones anteriores de iOS. Es útil para cualquier agente o desarrollador que necesite integrar o auditar el uso de Liquid Glass en aplicaciones SwiftUI.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

SwiftUI Liquid Glass

Atribución: copiado de Dimillian/Skills de @Dimillian (2025-12-31).

Resumen

Usa esta habilidad para construir o revisar características de SwiftUI que se alineen completamente con la API Liquid Glass de iOS 26+. Prioriza las APIs nativas (glassEffect, GlassEffectContainer, estilos de botón de vidrio) y las guías de diseño de Apple. Mantén un uso consistente, interactivo donde sea necesario y consciente del rendimiento.

Árbol de Decisión del Flujo de Trabajo

Elige la ruta que coincida con la solicitud:

1) Revisar una característica existente

  • Inspecciona dónde se debe usar Liquid Glass y dónde no.
  • Verifica el orden correcto de modificadores, el uso de formas y la colocación de contenedores.
  • Comprueba el manejo de disponibilidad para iOS 26+ y fallbacks razonables.

2) Mejorar una característica usando Liquid Glass

  • Identifica los componentes objetivo para el tratamiento de vidrio (superficies, chips, botones, tarjetas).
  • Refactoriza para usar GlassEffectContainer donde aparezcan múltiples elementos de vidrio.
  • Introduce vidrio interactivo solo para elementos táctiles o enfocables.

3) Implementar una nueva característica usando Liquid Glass

  • Diseña primero las superficies de vidrio y las interacciones (forma, prominencia, agrupación).
  • Agrega modificadores de vidrio después de los modificadores de diseño/apariencia.
  • Agrega transiciones de morphing solo cuando la jerarquía de vistas cambie con animación.

Directrices Principales

  • Prefiere las APIs nativas de Liquid Glass sobre los desenfoques personalizados.
  • Usa GlassEffectContainer cuando varios elementos de vidrio coexistan.
  • Aplica .glassEffect(...) después de los modificadores de diseño y visuales.
  • Usa .interactive() para elementos que responden al tacto/pointer.
  • Mantén las formas consistentes en elementos relacionados para una apariencia cohesiva.
  • Protege con #available(iOS 26, *) y proporciona un fallback sin vidrio.

Lista de Verificación de Revisión

  • Disponibilidad: #available(iOS 26, *) presente con UI de fallback.
  • Composición: Vistas de vidrio múltiples envueltas en GlassEffectContainer.
  • Orden de modificadores: glassEffect aplicado después de modificadores de diseño/apariencia.
  • Interactividad: interactive() solo donde existe interacción del usuario.
  • Transiciones: glassEffectID usado con @Namespace para morphing.
  • Consistencia: Formas, tintes y espaciado alineados en toda la característica.

Lista de Verificación de Implementación

  • Define los elementos objetivo y la prominencia de vidrio deseada.
  • Envuelve los elementos de vidrio agrupados en GlassEffectContainer y ajusta el espaciado.
  • Usa .glassEffect(.regular.tint(...).interactive(), in: .rect(cornerRadius: ...)) según sea necesario.
  • Usa .buttonStyle(.glass) / .buttonStyle(.glassProminent) para acciones.
  • Agrega transiciones de morphing con glassEffectID cuando la jerarquía cambie.
  • Proporciona materiales y visuales de fallback para versiones anteriores de iOS.

Fragmentos Rápidos

Usa estos patrones directamente y adapta formas, tintes y espaciado.

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("Confirmar") { }
    .buttonStyle(.glassProminent)

Recursos

  • Guía de referencia: references/liquid-glass.md
  • Prefiere la documentación de Apple para obtener detalles actualizados de la 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.

Skills relacionados