Communitygithub.com

ulasalyesil/personal-website-v2

Bonnes pratiques et exemples guidés pour créer des vues et composants SwiftUI. À utiliser lors de la création ou de la refonte d'interfaces SwiftUI, de la conception d'architecture d'onglets avec TabView, de la composition d'écrans ou du besoin de modèles et exemples spécifiques à un composant.

Qu'est-ce que personal-website-v2 ?

Ce skill fournit des directives structurées et des exemples concrets pour le développement d'interfaces utilisateur SwiftUI. Il couvre à la fois la mise en place de nouveaux projets et la modification de projets existants, en mettant l'accent sur l'utilisation d'outils SwiftUI modernes comme `@State`, `@Observable`, et `.task` pour la gestion d'état et le travail asynchrone. Le skill propose des workflows détaillés pour créer de nouvelles vues, utiliser des feuilles modales de manière idiomatique (`.sheet(item:)`), et structurer l'application autour de `TabView` et `NavigationStack`. Il est conçu pour les développeurs travaillant sur des applications iOS ou macOS avec SwiftUI, et repose sur une base de références de composants indexés pour une consultation rapide. L'objectif est d'homogénéiser le code SwiftUI au sein d'un projet, d'éviter les anti-patrons et de favoriser la composition et la réutilisabilité.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Modèles d'interface SwiftUI

Démarrage rapide

Choisissez un parcours selon votre objectif :

Projet existant

  • Identifiez la fonctionnalité ou l'écran et le principal modèle d'interaction (liste, détail, éditeur, paramètres, onglets).
  • Trouvez un exemple proche dans le dépôt avec rg "TabView\(" ou similaire, puis lisez la vue SwiftUI la plus proche.
  • Appliquez les conventions locales : privilégiez l'état natif SwiftUI, conservez l'état local quand c'est possible, et utilisez l'injection d'environnement pour les dépendances partagées.
  • Choisissez la référence de composant pertinente dans references/components-index.md et suivez ses instructions.
  • Construisez la vue avec des sous-vues petites et ciblées et un flux de données natif SwiftUI.

Nouveau squelette de projet

  • Commencez par references/app-scaffolding-wiring.md pour câbler TabView + NavigationStack + sheets.
  • Ajoutez un AppTab et un RouterPath minimaux basés sur les squelettes fournis.
  • Choisissez la prochaine référence de composant en fonction de l'interface dont vous avez besoin en premier (TabView, NavigationStack, Sheets).
  • Étendez les énumérations de routes et de feuilles au fur et à mesure que de nouveaux écrans sont ajoutés.

Règles générales à suivre

  • Utilisez l'état SwiftUI moderne (@State, @Binding, @Observable, @Environment) et évitez les modèles de vue inutiles.
  • Préférez la composition ; gardez les vues petites et ciblées.
  • Utilisez async/await avec .task et des états de chargement/erreur explicites.
  • Maintenez les modèles hérités existants uniquement lors de la modification de fichiers hérités.
  • Suivez le formateur et le guide de style du projet.
  • Feuilles : Préférez .sheet(item:) à .sheet(isPresented:) lorsque l'état représente un modèle sélectionné. Évitez if let dans le corps d'une feuille. Les feuilles doivent posséder leurs actions et appeler dismiss() en interne au lieu de transmettre des fermetures onCancel/onConfirm.

Workflow pour une nouvelle vue SwiftUI

  1. Définissez l'état de la vue et son emplacement de propriété.
  2. Identifiez les dépendances à injecter via @Environment.
  3. Esquissez la hiérarchie de la vue et extrayez les parties répétées dans des sous-vues.
  4. Implémentez le chargement asynchrone avec .task et un énumérateur d'état explicite si nécessaire.
  5. Ajoutez des étiquettes ou identifiants d'accessibilité lorsque l'interface est interactive.
  6. Validez avec une compilation et mettez à jour les sites d'appels si nécessaire.

Références de composants

Utilisez references/components-index.md comme point d'entrée. Chaque référence de composant doit inclure :

  • L'intention et les scénarios les mieux adaptés.
  • Un modèle d'utilisation minimal avec les conventions locales.
  • Les pièges et les notes de performance.
  • Les chemins vers les exemples existants dans le dépôt actuel.

Modèles de feuilles

Feuille pilotée par élément (préférée)

@State private var selectedItem: Item?

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

La feuille possède ses actions

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

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

Ajout d'une nouvelle référence de composant

  • Créez references/<composant>.md.
  • Gardez-le court et actionnable ; liez des fichiers concrets dans le dépôt actuel.
  • Mettez à jour references/components-index.md avec la nouvelle entrée.

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

Skills associés