For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navegación principal
Theme
Codex

Codex use case

Adopta Liquid Glass

Usa Codex para migrar una app existente de SwiftUI a Liquid Glass con las API de iOS 26 y Xcode 26.

Difficulty Advanced
Time horizon 1h

Usa Codex y el complemento Build iOS Apps para revisar la interfaz actual en iPhone y iPad y reemplazar las capas personalizadas de desenfoque o materiales por Liquid Glass nativo. Para migrar de forma segura, comprueba la disponibilidad de las API de iOS 26 y valida los cambios en el simulador.

Best for

  • Apps existentes de SwiftUI que necesitan un plan concreto para migrar a Liquid Glass en iOS 26 en lugar de una propuesta vaga de rediseño
  • Equipos que quieren que Codex revise las tarjetas, hojas, barras de pestañas, barras de herramientas y botones de acción personalizados y luego implemente la migración por partes
  • Apps que aún admiten versiones anteriores de iOS y necesitan conservar una interfaz alternativa mediante `#available(iOS 26, *)` en lugar de reemplazar por completo el diseño anterior

Contents

    ← All use cases

    Adopta Liquid Glass

    Usa Codex para migrar una app existente de SwiftUI a Liquid Glass con las API de iOS 26 y Xcode 26.

    Usa Codex y el complemento Build iOS Apps para revisar la interfaz actual en iPhone y iPad y reemplazar las capas personalizadas de desenfoque o materiales por Liquid Glass nativo. Para migrar de forma segura, comprueba la disponibilidad de las API de iOS 26 y valida los cambios en el simulador.

    Advanced
    1h

    Usa Codex y el complemento Build iOS Apps para revisar la interfaz actual en iPhone y iPad y reemplazar las capas personalizadas de desenfoque o materiales por Liquid Glass nativo. Para migrar de forma segura, comprueba la disponibilidad de las API de iOS 26 y valida los cambios en el simulador.

    Advanced
    1h

    Best for

    • Apps existentes de SwiftUI que necesitan un plan concreto para migrar a Liquid Glass en iOS 26 en lugar de una propuesta vaga de rediseño
    • Equipos que quieren que Codex revise las tarjetas, hojas, barras de pestañas, barras de herramientas y botones de acción personalizados y luego implemente la migración por partes
    • Apps que aún admiten versiones anteriores de iOS y necesitan conservar una interfaz alternativa mediante `#available(iOS 26, *)` en lugar de reemplazar por completo el diseño anterior

    Skills & Plugins

    • Usa las habilidades de Liquid Glass en SwiftUI, de patrones de interfaz en SwiftUI y de depuración en el simulador para modernizar las pantallas de iOS, aplicar efectos de vidrio nativos y verificar el resultado en simuladores de iOS 26.
    Skill Why use it
    Build iOS Apps Usa las habilidades de Liquid Glass en SwiftUI, de patrones de interfaz en SwiftUI y de depuración en el simulador para modernizar las pantallas de iOS, aplicar efectos de vidrio nativos y verificar el resultado en simuladores de iOS 26.

    Starter prompt

    Usa el complemento Build iOS Apps y su habilidad SwiftUI Liquid Glass para migrar a Liquid Glass uno de los flujos más utilizados de esta app. Restricciones: - Haz la migración con iOS 26 y Xcode 26, pero conserva una alternativa sin efecto de vidrio para versiones anteriores de iOS mediante `#available(iOS 26, *)`. - Revisa primero el flujo. Identifica los fondos personalizados, las capas de desenfoque superpuestas, los chips, los botones, las hojas y las barras de herramientas que deberían usar Liquid Glass nativo. Indica también qué superficies deberían seguir mostrando el contenido sin efectos. - Prioriza los controles del sistema y las API nativas como `glassEffect`, `GlassEffectContainer`, `glassEffectID`, `.buttonStyle(.glass)` y `.buttonStyle(.glassProminent)` frente a los desenfoques personalizados. Usa `glassEffectID` con `@Namespace` solo cuando una transición de una forma a otra mejore el flujo. - Aplica `glassEffect` después de los modificadores de disposición y apariencia, mantén la coherencia de las formas y usa `.interactive()` solo en los controles que respondan al tacto. - Usa XcodeBuildMCP para compilar y ejecutar la app en un simulador de iOS 26. Toma capturas de pantalla del flujo migrado y especifica qué esquema y simulador usaste y qué comprobaciones hiciste. Entrega lo siguiente: - un plan breve para migrar el flujo - la parte del flujo que implementaste con Liquid Glass - una descripción de cómo funciona la alternativa sin efecto de vidrio en dispositivos con versiones anteriores a iOS 26 - los pasos que seguiste para validar el flujo en el simulador y las capturas de pantalla que usaste
    Usa el complemento Build iOS Apps y su habilidad SwiftUI Liquid Glass para migrar a Liquid Glass uno de los flujos más utilizados de esta app. Restricciones: - Haz la migración con iOS 26 y Xcode 26, pero conserva una alternativa sin efecto de vidrio para versiones anteriores de iOS mediante `#available(iOS 26, *)`. - Revisa primero el flujo. Identifica los fondos personalizados, las capas de desenfoque superpuestas, los chips, los botones, las hojas y las barras de herramientas que deberían usar Liquid Glass nativo. Indica también qué superficies deberían seguir mostrando el contenido sin efectos. - Prioriza los controles del sistema y las API nativas como `glassEffect`, `GlassEffectContainer`, `glassEffectID`, `.buttonStyle(.glass)` y `.buttonStyle(.glassProminent)` frente a los desenfoques personalizados. Usa `glassEffectID` con `@Namespace` solo cuando una transición de una forma a otra mejore el flujo. - Aplica `glassEffect` después de los modificadores de disposición y apariencia, mantén la coherencia de las formas y usa `.interactive()` solo en los controles que respondan al tacto. - Usa XcodeBuildMCP para compilar y ejecutar la app en un simulador de iOS 26. Toma capturas de pantalla del flujo migrado y especifica qué esquema y simulador usaste y qué comprobaciones hiciste. Entrega lo siguiente: - un plan breve para migrar el flujo - la parte del flujo que implementaste con Liquid Glass - una descripción de cómo funciona la alternativa sin efecto de vidrio en dispositivos con versiones anteriores a iOS 26 - los pasos que seguiste para validar el flujo en el simulador y las capturas de pantalla que usaste

    Toma iOS 26 como punto de partida

    Aborda la adopción de Liquid Glass primero como una migración a iOS 26 y Xcode 26. Vuelve a compilar la app con el SDK de iOS 26 y revisa qué cambios se aplican automáticamente a los controles estándar de SwiftUI. Solo entonces pídele a Codex que rediseñe los elementos personalizados que aún se ven demasiado planos, tienen demasiado peso visual o se integran mal con la interfaz del sistema.

    Si la app aún admite versiones anteriores de iOS, acláralo desde el principio. La habilidad SwiftUI Liquid Glass del complemento Build iOS Apps debe usar #available(iOS 26, *) para que las nuevas API exclusivas de Liquid Glass se usen solo cuando estén disponibles y mantener una alternativa legible en dispositivos más antiguos.

    Aprovecha el complemento de iOS

    Usa el complemento Build iOS Apps cuando quieras que Codex modifique una interfaz de SwiftUI y verifique los cambios en un simulador. Para trabajar con Liquid Glass, pídele a Codex que revise un solo flujo, migre unas pocas superficies, ejecute la app en un simulador de iOS 26 y tome capturas de pantalla antes de ampliar el alcance.

    El complemento incluye la habilidad SwiftUI Liquid Glass. Conviene incorporar estas pautas predeterminadas en tu prompt:

    • Da preferencia a las opciones nativas como glassEffect, GlassEffectContainer, los estilos de botón con efecto de vidrio y las transiciones con glassEffectID frente a las vistas con desenfoque personalizado.
    • Aplica .glassEffect(...) después de los modificadores de disposición y apariencia para que el material se ajuste a la forma final que buscas.
    • Agrupa los elementos de vidrio relacionados en un GlassEffectContainer cuando aparezcan varias superficies juntas.
    • Usa .interactive() solo en botones, chips y controles que respondan al tacto.
    • Mantén la coherencia en la forma de las esquinas, los tintes y el espaciado en toda la función. Evita aplicar un efecto de vidrio distinto a cada elemento.
    • Conserva una alternativa sin efecto de vidrio para las versiones anteriores a iOS 26.

    Para saber cómo instalar complementos y habilidades, consulta la documentación sobre complementos y habilidades.

    Mira las sesiones de la WWDC

    Estas sesiones de la WWDC25 son una buena referencia antes de pedirle a Codex que refactorice un flujo que ya está en producción:

    Pide un plan de migración y luego la implementación de una parte

    Las migraciones a Liquid Glass funcionan mejor cuando Codex distingue entre “¿dónde conviene aplicar el efecto de vidrio?” y “escribe todo el código ahora”. Pide primero una revisión rápida y luego deja que el agente implemente una parte independiente y la pruebe en el simulador.

    Consejos prácticos

    Aplica el efecto de vidrio de forma selectiva

    Liquid Glass debe distinguir claramente la capa de controles que aparece sobre el contenido, sin convertir cada tarjeta en un panel brillante. Pídele a Codex que quite los fondos decorativos que compitan visualmente con los materiales del sistema, mantenga una presentación sencilla donde la legibilidad sea prioritaria y reserve los tintes para destacar el significado de un elemento o resaltar las acciones principales.

    Empieza por un flujo de uso frecuente

    La vista principal de una pestaña, una pantalla de detalle, una hoja, una interfaz de búsqueda o un flujo de bienvenida suele ser un mejor punto de partida que migrar toda la app de una vez. Así es más fácil revisar los cambios e identificar qué decisiones de diseño con Liquid Glass conviene convertir en patrones de componentes reutilizables.

    Revisa cómo funciona la alternativa sin efecto de vidrio

    Si la versión mínima de iOS que admite tu app es anterior a iOS 26, pídele a Codex que te muestre la implementación alternativa junto a la versión con Liquid Glass. Esta revisión permite detectar si un cambio introdujo por error el uso de una API que no está disponible en alguna versión compatible y evita que publiques una migración que solo funcione en el simulador más reciente.

    Tech stack

    Need

    API de interfaz de Liquid Glass

    Default options

    SwiftUI con glassEffect, GlassEffectContainer y estilos de botón con efecto de vidrio

    Why it's needed

    La habilidad debería usar primero estas API nativas para que Codex elimine las capas de desenfoque personalizadas sin tener que recrear el sistema de materiales.

    Need

    Versiones de referencia

    Default options

    iOS 26 y Xcode 26

    Why it's needed

    Liquid Glass está disponible a partir del SDK de iOS 26. Codex debería compilar la app con Xcode 26 y definir explícitamente el comportamiento alternativo para las versiones anteriores de iOS.

    Need

    Validación en el simulador

    Default options

    XcodeBuildMCP

    Why it's needed

    Durante una migración visual, es importante compilar e iniciar la app, tomar capturas de pantalla y revisar los registros, sobre todo al evaluar distintos estados de la interfaz y tamaños de dispositivo.

    Need Default options Why it's needed
    API de interfaz de Liquid Glass SwiftUI con glassEffect , GlassEffectContainer y estilos de botón con efecto de vidrio La habilidad debería usar primero estas API nativas para que Codex elimine las capas de desenfoque personalizadas sin tener que recrear el sistema de materiales.
    Versiones de referencia iOS 26 y Xcode 26 Liquid Glass está disponible a partir del SDK de iOS 26. Codex debería compilar la app con Xcode 26 y definir explícitamente el comportamiento alternativo para las versiones anteriores de iOS.
    Validación en el simulador XcodeBuildMCP Durante una migración visual, es importante compilar e iniciar la app, tomar capturas de pantalla y revisar los registros, sobre todo al evaluar distintos estados de la interfaz y tamaños de dispositivo.

    Related use cases