Communitygithub.com

ulasalyesil/personal-website-v2

Best Practices und beispielorientierte Anleitung zum Erstellen von SwiftUI-Views und -Komponenten. Verwenden Sie dies beim Erstellen oder Refactoren von SwiftUI-Oberflächen, beim Entwerfen einer Tab-Architektur mit TabView, beim Zusammensetzen von Bildschirmen oder bei der Suche nach komponentenspezifischen Mustern und Beispielen.

Was ist personal-website-v2?

Diese Skill-Anleitung bietet einen umfassenden Leitfaden für die Entwicklung von SwiftUI-UI-Komponenten und -Patterns. Sie richtet sich an Entwickler, die SwiftUI-Views erstellen oder überarbeiten, insbesondere bei der Arbeit mit TabView, NavigationStack, Sheets und anderen gängigen UI-Strukturen. Die Anleitung unterstützt sowohl neue Projekte (Scaffolding mit TabView + NavigationStack) als auch die Integration in bestehende Projekte. Sie betont die Verwendung moderner SwiftUI-State-Mechanismen wie @State, @Binding, @Observable und @Environment, empfiehlt die Komposition kleiner, fokussierter Subviews und liefert konkrete Codebeispiele für das bevorzugte Sheet-Muster (.sheet(item:)) sowie für das Speichern von Aktionen innerhalb der Sheet-View. Ein Verzeichnis mit Komponentenreferenzen (references/components-index.md) dient als Einstiegspunkt für detaillierte Muster zu bestimmten UI-Elementen.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

SwiftUI UI Patterns

Schnellstart

Wählen Sie einen Pfad basierend auf Ihrem Ziel:

Bestehendes Projekt

  • Identifizieren Sie die Funktion oder den Bildschirm und das primäre Interaktionsmodell (Liste, Detail, Editor, Einstellungen, Tabbed).
  • Finden Sie ein nahegelegenes Beispiel im Repository mit rg "TabView\(" oder ähnlich, und lesen Sie dann die nächstgelegene SwiftUI-View.
  • Wenden Sie lokale Konventionen an: bevorzugen Sie SwiftUI-nativen State, halten Sie State möglichst lokal und verwenden Sie Environment Injection für gemeinsame Abhängigkeiten.
  • Wählen Sie die relevante Komponentenreferenz aus references/components-index.md und folgen Sie deren Anleitung.
  • Erstellen Sie die View mit kleinen, fokussierten Subviews und SwiftUI-nativem Datenfluss.

Neues Projekt-Scaffolding

  • Beginnen Sie mit references/app-scaffolding-wiring.md, um TabView + NavigationStack + Sheets zu verdrahten.
  • Fügen Sie ein minimales AppTab und RouterPath basierend auf den bereitgestellten Skeletten hinzu.
  • Wählen Sie die nächste Komponentenreferenz basierend auf der UI, die Sie zuerst benötigen (TabView, NavigationStack, Sheets).
  • Erweitern Sie die Route- und Sheet-Enums, wenn neue Bildschirme hinzugefügt werden.

Allgemeine Regeln

  • Verwenden Sie modernen SwiftUI-State (@State, @Binding, @Observable, @Environment) und vermeiden Sie unnötige View-Modelle.
  • Bevorzugen Sie Komposition; halten Sie Views klein und fokussiert.
  • Verwenden Sie async/await mit .task und expliziten Lade-/Fehlerzuständen.
  • Behalten Sie bestehende Legacy-Patterns nur bei, wenn Sie Legacy-Dateien bearbeiten.
  • Befolgen Sie den Formatierungs- und Style-Guide des Projekts.
  • Sheets: Bevorzugen Sie .sheet(item:) gegenüber .sheet(isPresented:), wenn der State ein ausgewähltes Modell repräsentiert. Vermeiden Sie if let im Sheet-Body. Sheets sollten ihre Aktionen selbst verwalten und dismiss() intern aufrufen, anstatt onCancel/onConfirm-Closures zu übergeben.

Workflow für eine neue SwiftUI-View

  1. Definieren Sie den State der View und dessen Eigentumsort.
  2. Identifizieren Sie Abhängigkeiten, die über @Environment injiziert werden.
  3. Skizzieren Sie die View-Hierarchie und extrahieren Sie wiederholte Teile in Subviews.
  4. Implementieren Sie asynchrones Laden mit .task und ggf. einem expliziten State-Enum.
  5. Fügen Sie Accessibility-Labels oder -Identifier hinzu, wenn die UI interaktiv ist.
  6. Validieren Sie mit einem Build und aktualisieren Sie ggf. die Aufrufstellen.

Komponentenreferenzen

Verwenden Sie references/components-index.md als Einstiegspunkt. Jede Komponentenreferenz sollte Folgendes enthalten:

  • Verwendungszweck und optimale Einsatzszenarien.
  • Minimales Nutzungsmuster mit lokalen Konventionen.
  • Fallstricke und Leistungshinweise.
  • Pfade zu vorhandenen Beispielen im aktuellen Repository.

Sheet-Patterns

Item-gesteuertes Sheet (bevorzugt)

@State private var selectedItem: Item?

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

Sheet verwaltet seine Aktionen selbst

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 ? "Speichern…" : "Speichern") {
                Task { await save() }
            }
        }
    }

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

Hinzufügen einer neuen Komponentenreferenz

  • Erstellen Sie references/<component>.md.
  • Halten Sie sie kurz und handlungsorientiert; verlinken Sie auf konkrete Dateien im aktuellen Repository.
  • Aktualisieren Sie references/components-index.md mit dem neuen Eintrag.

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

Verwandte Skills