Communitygithub.com

ComeOnOliver/skillshub

Se utiliza al implementar funciones de SwiftUI para iOS 26. Cubre el sistema de diseño Liquid Glass, mejoras de rendimiento, la macro @Animatable, diseño espacial 3D, puente de escenas, WebView/WebPage, edición de texto enriquecido con AttributedString, mejoras de arrastrar y soltar, e integración con visionOS para iOS 26 y posteriores.

¿Qué es skillshub?

Esta skill proporciona una guía completa de las nuevas funcionalidades de SwiftUI en iOS 26, iPadOS 26, macOS Tahoe, watchOS 26 y visionOS 26. Abarca desde el sistema de diseño Liquid Glass hasta la edición de texto enriquecido, ofreciendo mejoras sustanciales en todas las plataformas Apple. Es especialmente útil para desarrolladores que adoptan el nuevo diseño Liquid Glass, implementan edición de texto enriquecido con AttributedString, optimizan el rendimiento de listas y scrolls, utilizan la macro @Animatable para animaciones personalizadas, construyen diseños espaciales 3D en visionOS, o integran escenas de SwiftUI con aplicaciones UIKit/AppKit. La documentación incluye APIs detalladas, fragmentos de código Swift, y ejemplos prácticos para cada característica, desde barras de herramientas personalizables hasta gráficos 3D con Chart3D. Funciona en todas las plataformas Apple compatibles con iOS 26 y versiones posteriores.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/CharlesWiltgen/Axiom/axiom-swiftui-26-ref

Preguntar en tu IA favorita

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

Documentación

Funcionalidades de SwiftUI 26

Resumen

Guía completa de las nuevas funcionalidades de SwiftUI en iOS 26, iPadOS 26, macOS Tahoe, watchOS 26 y visionOS 26. Desde el sistema de diseño Liquid Glass hasta la edición de texto enriquecido, estas mejoras hacen que SwiftUI sea más potente en todas las plataformas Apple.

Principio fundamental Desde mejoras de rendimiento de bajo nivel hasta los botones de tu interfaz de usuario, hay mejoras importantes en todo el sistema.

Cuándo Usar Esta Skill

  • Adoptar el sistema de diseño Liquid Glass
  • Implementar edición de texto enriquecido con AttributedString
  • Incrustar contenido web con WebView
  • Optimizar el rendimiento de listas y scroll
  • Usar la macro @Animatable para animaciones personalizadas
  • Construir diseños espaciales 3D en visionOS
  • Vincular escenas de SwiftUI a aplicaciones UIKit/AppKit
  • Implementar arrastrar y soltar con múltiples elementos
  • Crear gráficos 3D con Chart3D
  • Agregar widgets a visionOS o CarPlay
  • Agregar marcas de graduación personalizadas a sliders (marcadores de capítulo, indicadores de valor)
  • Restringir rangos de selección de sliders con enabledBounds
  • Personalizar la apariencia del slider (visibilidad del pulgar, etiquetas de valor actual)
  • Crear barras de área segura adhesivas con efectos de desenfoque
  • Abrir URLs en un navegador dentro de la aplicación
  • Usar botones de cerrar y confirmar con estilo del sistema
  • Aplicar estilos de botón de vidrio (iOS 26.1+)
  • Controlar el comportamiento de tamaño de los botones
  • Implementar barras de herramientas de búsqueda compactas
  • Ajustar la altura de línea o el espaciado de línea base para texto

Requisitos del Sistema

iOS 26+, iPadOS 26+, macOS Tahoe+, watchOS 26+, visionOS 26+


Sistema de Diseño Liquid Glass

Para una cobertura completa, consulta axiom-liquid-glass (principios de diseño, variantes, presión de revisión) y axiom-liquid-glass-ref (guía de adopción en toda la aplicación). Esta sección cubre solo las APIs específicas de WWDC 256.

Adopción Automática

Recompila con el SDK de iOS 26: los contenedores de navegación, barras de pestañas, barras de herramientas, conmutadores, selectores segmentados y sliders adoptan automáticamente el nuevo diseño. Los botones con borde tienen por defecto forma de cápsula. Las hojas obtienen un fondo Liquid Glass (elimina cualquier personalización de presentationBackground).

APIs de Barra de Herramientas (iOS 26)

ToolbarSpacer

.toolbar {
    ToolbarItem(placement: .bottomBar) { Button("Archivar", systemImage: "archivebox") { } }
    ToolbarSpacer(.flexible, placement: .bottomBar)  // Separa elementos
    ToolbarItem(placement: .bottomBar) { Button("Redactar", systemImage: "square.and.pencil") { } }
}
// .fixed separa grupos visualmente; .flexible separa (como Spacer en HStack)

ToolbarItemGroup (Agrupación Visual)

Los elementos en un ToolbarItemGroup comparten un solo fondo de vidrio "píldora". ToolbarItemPlacement controla la apariencia visual: confirmationAction → estilo glassProminent, cancellationAction → vidrio estándar. Usa .sharedBackgroundVisibility(.hidden) para excluir elementos (por ejemplo, avatares) del fondo del grupo.

Transformación de Barra de Herramientas

Adjunta .toolbar {} a vistas individuales dentro de NavigationStack (no al propio NavigationStack). iOS 26 transforma entre barras de herramientas por vista durante push/pop. Usa toolbar(id:) con ToolbarItem(id:) coincidente en todas las pantallas para elementos que deben permanecer estables (sin rebote):

// MailboxList
.toolbar(id: "main") {
    ToolbarItem(id: "filter", placement: .bottomBar) { Button("Filtrar") { } }
    ToolbarSpacer(.flexible, placement: .bottomBar)
    ToolbarItem(id: "compose", placement: .bottomBar) { Button("Nuevo Mensaje") { } }
}
// MessageList — "filter" ausente (se anima al salir), "compose" permanece estable
.toolbar(id: "main") {
    ToolbarSpacer(.flexible, placement: .bottomBar)
    ToolbarItem(id: "compose", placement: .bottomBar) { Button("Nuevo Mensaje") { } }
}

Error común #1: Barra de herramientas en NavigationStack = nada que transformar.

DefaultToolbarItem

Reposiciona elementos proporcionados por el sistema (como la búsqueda) dentro de tu diseño de barra de herramientas:

DefaultToolbarItem(kind: .search, placement: .bottomBar)
// Reemplaza la ubicación predeterminada del sistema para el tipo coincidente

Úsalo en la barra lateral colapsada de NavigationSplitView para especificar qué columna muestra la búsqueda en iPhone. Envuélvelo en if #available(iOS 26.0, *) para compatibilidad con versiones anteriores.

Barras de Herramientas Personalizables por el Usuario

toolbar(id:) permite la personalización por parte del usuario (reorganizar, mostrar/ocultar). Solo los elementos .secondaryAction admiten personalización en iPadOS. Usa showsByDefault: false para elementos opcionales. Agrega ToolbarCommands() para el elemento de menú en macOS.

Otras Funcionalidades de Barra de Herramientas

  • .navigationSubtitle("3 no leídos") — Línea secundaria debajo del título
  • .badge(3) en elementos de barra de herramientas — Contadores de notificaciones
  • Renderizado de iconos monocromáticos — Reduce el ruido visual; usa tinte para significado, no para decoración
  • Desenfoque en bordes de desplazamiento — Automático, sin código requerido

Búsqueda Alineada en la Parte Inferior

APIs de búsqueda fundamentales: Consulta axiom-swiftui-search-ref. Esta sección cubre solo los refinamientos de iOS 26.

NavigationSplitView {
    List { }.searchable(text: $searchText)
}
// Alineado en la parte inferior en iPhone, en la parte superior derecha en iPad (automático)
// Usa placement: .sidebar para restaurar la búsqueda incrustada en la barra lateral en iPad
  • searchToolbarBehavior(.minimize) — Búsqueda compacta que se expande al tocar
  • Tab(role: .search) — Pestaña de búsqueda dedicada; el campo de búsqueda reemplaza la barra de pestañas. Consulta swiftui-nav-ref Sección 5.7

Efecto de Vidrio para Vistas Personalizadas

Button("Arriba", systemImage: "chevron.up") { scrollToTop() }
    .padding()
    .glassEffect()  // Agrega .interactive para controles personalizados en iOS
  • GlassEffectContainer — Requerido cuando hay múltiples elementos de vidrio cerca (el vidrio no puede muestrear vidrio)
  • glassEffectID(_:in:) — Transiciones de transformación fluidas entre elementos de vidrio usando un espacio de nombres
  • Transformación de hojas — Usa .matchedTransitionSource + .navigationTransition(.zoom(...)) para transformar hojas desde botones

Cambios en Botones y Controles

  • Forma de cápsula predeterminada para botones con borde (anula con .buttonBorderShape(.roundedRectangle))
  • .controlSize(.extraLarge) — Nuevo tamaño de botón extragrande
  • .controlSize(.small) en contenedores — Conserva la densidad anterior a iOS 26
  • GlassButtonStyle(.clear/.glass/.tint) — Variantes de botón de vidrio (iOS 26.1+)
  • .buttonSizing(.fit/.stretch/.flexible) — Controla el comportamiento de diseño del botón
  • Button(role: .close) / Button(role: .confirm) — Botones de cerrar/confirmar con estilo del sistema
  • .clipShape(.rect(cornerRadius: 12, style: .containerConcentric)) — Concentricidad de esquinas
  • Menús: iconos en el borde izquierdo, consistentes en iOS/macOS

Mejoras en Sliders

iOS 26 agrega marcas de graduación personalizadas, rangos de selección restringidos, etiquetas de valor actual y control de visibilidad del pulgar.

Marcas de Graduación en Sliders

Tipos principales: SliderTick<V>, SliderTickContentForEach, SliderTickBuilder

// Marcas estáticas con etiquetas
Slider(value: $value, in: 0...10) {
    Text("Calificación")
} ticks: {
    SliderTick(0) { Text("Mín") }
    SliderTick(5) { Text("Med") }
    SliderTick(10) { Text("Máx") }
}

// Marcas dinámicas desde una colección
SliderTickContentForEach(stops, id: \.self) { value in
    SliderTick(value) { Text("\(Int(value))°").font(.caption2) }
}

// Marcas basadas en pasos (se llama para cada valor de paso)
Slider(value: $volume, in: 0...10, step: 2, label: { Text("Volumen") }, tick: { value in
    SliderTick(value) { Text("\(Int(value))") }
})

Restricción de API: SliderTickContentForEach requiere que Data.Element coincida con el tipo de valor de SliderTick<V>. Para estructuras personalizadas, extrae valores numéricos: chapters.map(\.time) y luego busca etiquetas mediante chapters.first(where: { $0.time == time }).

Slider con Funciones Completas

Slider(
    value: $rating, in: 0...100,
    neutralValue: 50,           // Punto de inicio / valor central
    enabledBounds: 20...80,     // Restringe el rango seleccionable
    label: { Text("Calificación") },
    currentValueLabel: { Text("\(Int(rating))") },
    minimumValueLabel: { Text("0") },
    maximumValueLabel: { Text("100") },
    ticks: { SliderTick(50) { Text("Med") } },
    onEditingChanged: { editing in print(editing ? "Iniciado" : "Finalizado") }
)

sliderThumbVisibility

.sliderThumbVisibility(.hidden) — Oculta el pulgar para indicadores de progreso de medios y UI minimalista. Opciones: .automatic, .visible, .hidden. Siempre visible en watchOS.


Nuevos Modificadores de Vista

safeAreaBar

Barras adhesivas con desenfoque progresivo integrado:

List { ForEach(1...20, id: \.self) { Text("\($0). Elemento") } }
    .safeAreaBar(edge: .bottom) {
        Text("Barra de acciones inferior").padding(.vertical, 15)
    }
    .scrollEdgeEffectStyle(.soft, for: .bottom) // o .hard

Funciona como safeAreaInset pero con desenfoque. La barra permanece fija mientras el contenido se desplaza debajo.

Mejora de onOpenURL

@Environment(\.openURL) var openURL
// openURL(url, prefersInApp: true) — Abre en un navegador dentro de la aplicación estilo SFSafariViewController
// El enlace predeterminado abre en Safari; prefersInApp mantiene a los usuarios en tu aplicación

searchToolbarBehavior

Consulta axiom-swiftui-search-ref para las APIs fundamentales de .searchable. iOS 26 agrega:

.searchable(text: $searchText)
.searchToolbarBehavior(.minimize)  // Botón compacto, se expande al tocar

También: .searchPresentationToolbarBehavior(.avoidHidingContent) (iOS 17.1+) mantiene el título visible durante la búsqueda.

Wrapper compatible con versiones anteriores para aplicaciones que apuntan a iOS 18+26:

extension View {
    @ViewBuilder func minimizedSearch() -> some View {
        if #available(iOS 26.0, *) {
            self.searchToolbarBehavior(.minimize)
        } else { self }
    }
}

// Uso
.searchable(text: $searchText)
.minimizedSearch()

Patrón de disponibilidad para elementos de barra de herramientas:

.toolbar {
    if #available(iOS 26.0, *) {
        DefaultToolbarItem(kind: .search, placement: .bottomBar)
        ToolbarSpacer(.flexible, placement: .bottomBar)
    }
    ToolbarItem(placement: .bottomBar) {
        NewNoteButton()
    }
}
.searchable(text: $searchText)

Roles de botón, GlassButtonStyle, buttonSizing — Consulta la sección Sistema de Diseño Liquid Glass anterior.

lineHeight (iOS 26)

Establece la distancia de línea base a línea base entre líneas de texto. Más intuitivo que .lineSpacing() que mide desde el final de una línea hasta el inicio de la siguiente.

Valores Predefinidos

Text("Lorem ipsum...")
    .lineHeight(.loose)     // Espaciado aumentado para diseños abiertos
    .lineHeight(.tight)     // Espaciado reducido para diseños compactos
    .lineHeight(.normal)    // Altura constante basada en múltiplo del tamaño de punto
    .lineHeight(.variable)  // Usa métricas de fuente para el cálculo de altura

Control Preciso

// Escala proporcionalmente al tamaño de fuente
Text("Escala con el tamaño del texto")
    .lineHeight(.multiple(factor: 2))

// Relativo al tamaño de punto con incremento fijo
Text("Relativo al tamaño de punto")
    .lineHeight(.leading(increase: 30))

// Valor fijo absoluto — NO escala con Dynamic Type
Text("Altura fija")
    .lineHeight(.exact(points: 30))

Soporte para AttributedString

var s = AttributedString("Párrafo\ncon múltiples\nlíneas.")
s.lineHeight = .exact(points: 32)
s.lineHeight = .multiple(factor: 2.5)
s.lineHeight = .loose

Comparación con APIs Existentes

APIMideDisponible
.lineHeight()De línea base a línea baseiOS 26+
.lineSpacing()Del final de una línea al inicio de la siguienteiOS 13+
.font(.body.leading(.tight))Valor predefinido de interlineado a nivel de fuenteiOS 14+

Referencia cruzada axiom-typography-ref — Sistema de tipografía completo que incluye Dynamic Type, seguimiento e internacionalización


Mejoras en iPad

Barra de Menú

Acceder a acciones comunes mediante un menú deslizable hacia abajo

.commands {
    TextEditingCommands() // Misma API que la barra de menú de macOS

    CommandGroup(after: .newItem) {
        Button("Agregar Nota") {
            addNote()
        }
        .keyboardShortcut("n", modifiers: [.command, .shift])
    }
}
// Crea una barra de menú en iPad cuando las personas deslizan hacia abajo

Ventanas Redimensionables

Redimensionamiento fluido en iPad

// SE REQUIERE MIGRACIÓN:
// Elimina la clave de lista de propiedades obsoleta en iPadOS 26:
// UIRequiresFullscreen (toda la clave obsoleta, todos los valores)

// Para navegación con vista dividida, el sistema muestra/oculta automáticamente las columnas
// según el espacio disponible durante el redimensionamiento
NavigationSplitView {
    Sidebar()
} detail: {
    Detail()
}
// Se adapta al redimensionamiento automáticamente

Referencia "Elevate the design of your iPad app" (WWDC 2025)


Mejoras de Ventanas en macOS

Animaciones de Redimensionamiento de Ventana Sincronizadas

.windowResizeAnchor(.topLeading) // Personaliza el origen de la animación

// SwiftUI ahora sincroniza la animación entre los cambios de tamaño de la vista de contenido
// y el redimensionamiento de la ventana - excelente para preservar la continuidad al cambiar de pestañas

Mejoras de Rendimiento

Rendimiento de Listas (Enfoque en macOS)

Grandes ganancias para listas grandes

  • Carga 6 veces más rápida para listas de 100,000+ elementos en macOS
  • Actualizaciones 16 veces más rápidas para listas grandes
  • Ganancias aún mayores para listas más grandes
  • Las mejoras benefician todas las plataformas (iOS, iPadOS, watchOS)
List(trips) { trip in // 100k+ elementos
    TripRow(trip: trip)
}
// Carga 6 veces más rápido, se actualiza 16 veces más rápido en macOS (iOS 26+)

Rendimiento de Scroll

Fotogramas perdidos reducidos

SwiftUI ha mejorado la programación de las actualizaciones de la interfaz de usuario en iOS y macOS. Esto mejora la capacidad de respuesta y permite que SwiftUI haga aún más trabajo para preparar los fotogramas próximos. En general, reduce la probabilidad de que tu aplicación pierda un fotograma al desplazarse rápidamente a altas frecuencias de actualización.

ScrollViews Anidados con Lazy Stacks

Carruseles de fotos y desplazamiento multieje

ScrollView(.horizontal) {
    LazyHStack {
        ForEach(photoSets) { photoSet in
            ScrollView(.vertical) {
                LazyVStack {
                    ForEach(photoSet.photos) { photo in
                        PhotoView(photo: photo)
                    }
                }
            }
        }
    }
}
// Los scrollviews anidados ahora retrasan correctamente la carga con lazy stacks
// Excelente para construir carruseles de fotos

Instrumento de Rendimiento de SwiftUI

Nueva herramienta de perfilado en Xcode

Carriles disponibles:

  • Actualizaciones largas de cuerpo de vista — Identifica cálculos de cuerpo costosos
  • Actualizaciones de vista de plataforma — Seguimiento de actualizaciones de vistas nativas

Individual skills in this repo

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

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Skills relacionados