Communitygithub.com

Padrões de UI em SwiftUI

Orientação baseada em melhores práticas e exemplos para construir views e componentes SwiftUI. Use ao criar ou refatorar UI SwiftUI, projetar arquitetura de abas com TabView, compor telas ou precisar de padrões e exemplos específicos de componentes.

O que é Padrões de UI em SwiftUI?

Este skill fornece diretrizes abrangentes e exemplos práticos para desenvolvimento de UI com SwiftUI, abrangendo desde scaffolding de novos projetos até a refatoração de views existentes. Ele ensina a usar estados modernos do SwiftUI como @State, @Binding, @Observable e @Environment, evitando view models desnecessários, e promove composição com subviews pequenas e focadas. O skill cobre padrões para sheets (preferindo .sheet(item:) sobre .sheet(isPresented:)), navegação com TabView e NavigationStack, e carregamento assíncrono com async/await e .task. É útil para desenvolvedores iOS que desejam seguir boas práticas da comunidade SwiftUI, manter consistência em projetos existentes ou iniciar novos projetos com uma base sólida. As referências de componentes são organizadas em um índice central (references/components-index.md) e cada componente inclui intenção, padrão de uso mínimo, armadilhas e caminhos para exemplos no repositório atual.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agent/skills/swiftui-ui-patterns

Perguntar na sua IA favorita

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

Documentação

O que Padrões de UI em SwiftUI faz?

Início rápido

Escolha uma trilha baseada no seu objetivo:

Projeto existente

  • Identifique a funcionalidade ou tela e o modelo de interação principal (lista, detalhe, editor, configurações, abas).
  • Encontre um exemplo próximo no repositório com rg "TabView\(" ou similar, depois leia a view SwiftUI mais próxima.
  • Aplique as convenções locais: prefira estado nativo do SwiftUI, mantenha o estado local quando possível e use injeção de ambiente para dependências compartilhadas.
  • Escolha a referência de componente relevante em references/components-index.md e siga suas orientações.
  • Construa a view com subviews pequenas e focadas e fluxo de dados nativo do SwiftUI.

Scaffolding de novo projeto

  • Comece com references/app-scaffolding-wiring.md para configurar TabView + NavigationStack + sheets.
  • Adicione um AppTab e RouterPath mínimos baseados nos esqueletos fornecidos.
  • Escolha a próxima referência de componente com base na UI que você precisa primeiro (TabView, NavigationStack, Sheets).
  • Expanda os enums de rota e sheet conforme novas telas são adicionadas.

Regras gerais a seguir

  • Use estado moderno do SwiftUI (@State, @Binding, @Observable, @Environment) e evite view models desnecessários.
  • Prefira composição; mantenha as views pequenas e focadas.
  • Use async/await com .task e estados explícitos de carregamento/erro.
  • Mantenha os padrões legados existentes apenas ao editar arquivos legados.
  • Siga o formatador e guia de estilo do projeto.
  • Sheets: Prefira .sheet(item:) em vez de .sheet(isPresented:) quando o estado representar um modelo selecionado. Evite if let dentro do corpo de uma sheet. As sheets devem ser donas de suas ações e chamar dismiss() internamente em vez de encaminhar closures onCancel/onConfirm.

Fluxo de trabalho para uma nova view SwiftUI

  1. Defina o estado da view e sua localização de propriedade.
  2. Identifique dependências a serem injetadas via @Environment.
  3. Esboce a hierarquia da view e extraia partes repetidas em subviews.
  4. Implemente carregamento assíncrono com .task e enum de estado explícito se necessário.
  5. Adicione rótulos ou identificadores de acessibilidade quando a UI for interativa.
  6. Valide com uma compilação e atualize os locais de uso se necessário.

Referências de componentes

Use references/components-index.md como ponto de entrada. Cada referência de componente deve incluir:

  • Intenção e cenários de melhor ajuste.
  • Padrão de uso mínimo com convenções locais.
  • Armadilhas e notas de desempenho.
  • Caminhos para exemplos existentes no repositório atual.

Padrões de sheet

Sheet orientada por item (preferida)

@State private var selectedItem: Item?

.sheet(item: $selectedItem) { item in
    EditItemSheet(item: item)
}

Sheet é dona de suas ações

struct EditItemSheet: View {
    @Environment(\.dismiss) private var dismiss
    @Environment(Store.self) private var store

    let item: Item
    @State private var isSaving = false

    var body: some View {
        VStack {
            Button(isSaving ? "Salvando…" : "Salvar") {
                Task { await save() }
            }
        }
    }

    private func save() async {
        isSaving = true
        await store.save(item)
        dismiss()
    }
}

Adicionando uma nova referência de componente

  • Crie references/<componente>.md.
  • Mantenha curto e acionável; vincule a arquivos concretos no repositório atual.
  • Atualize references/components-index.md com a nova entrada.

Individual skills in this repo

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

ulasalyesil/personal-website-v2

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

ulasalyesil/personal-website-v2

Conduct design interviews, generate five distinct UI variations in a temporary design lab, collect feedback, and produce implementation plans. Use when the user wants to explore UI design options, redesign existing components, or create new UI with multiple approaches to compare.

ulasalyesil/personal-website-v2

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

ulasalyesil/personal-website-v2

Design and implement microinteractions, motion design, transitions, and user feedback patterns. Use when adding polish to UI interactions, implementing loading states, or creating delightful user experiences.

ulasalyesil/personal-website-v2

This skill is for interface design — dashboards, admin panels, apps, tools, and interactive products. NOT for marketing design (landing pages, marketing sites, campaigns).

ulasalyesil/personal-website-v2

UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples.

ulasalyesil/personal-website-v2

Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance. Use when auditing websites for accessibility, fixing WCAG violations, or implementing accessible design patterns.

ulasalyesil/personal-website-v2

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

ulasalyesil/personal-website-v2

Enforces an opinionated UI baseline to prevent AI-generated interface slop.

ulasalyesil/personal-website-v2

Build modern, composable, and accessible React UI components following the components.build specification. Use when creating, reviewing, or refactoring component libraries, design systems, or any reusable UI components. Triggers on tasks involving component APIs, composition patterns, accessibility, styling systems, or TypeScript props.

ulasalyesil/personal-website-v2

Ship correct, complete metadata.

ulasalyesil/personal-website-v2

Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on source code — never implements, fixes, or refactors anything itself. Use when asked to audit a codebase, find improvement opportunities (bugs, security, performance, test coverage, tech debt, migrations, DX), suggest features or where to take the project next (roadmap, product direction), or generate handoff plans for another agent to implement.

ulasalyesil/personal-website-v2

Defines the product's objects, relationships, states, and vocabulary independently of any interface — the most load-bearing layer

ulasalyesil/personal-website-v2

Maps domain concepts, terminology conflicts, and bounded contexts — produces a noun harvest for the conceptual model layer

ulasalyesil/personal-website-v2

Maps interaction structure and flow — produces breadboard notation with edge cases, failure paths, and open decisions

ulasalyesil/personal-website-v2

Framework orientation for Layers of Product Design — load this first; provides the context all other skills depend on

ulasalyesil/personal-website-v2

User research planning and synthesis at the observed behaviour layer — produces candidate job stories with confidence ratings

ulasalyesil/personal-website-v2

Diagnostic audit across all seven layers — identifies the bottleneck layer and recommends where to focus

ulasalyesil/personal-website-v2

Connects user opportunities to business outcomes and solution bets — produces a strategy tree and prioritised experiments

ulasalyesil/personal-website-v2

Audits existing surface against lower-layer decisions and produces a surface decision inventory — vocabulary, object consistency, completeness, feedback, hierarchy, accessibility

Habilidades Relacionadas