Communitygithub.com

CharbelElBateh/personal-website

Apples Ansatz für Interface-Design und fließende, physische Bewegung, übersetzt für das Web. Verwenden Sie dies beim Erstellen oder Überprüfen von gestengesteuerten Benutzeroberflächen, Federanimationen, Drag/Swipe/Sheet-Interaktionen, Momentum und unterbrechbaren Übergängen, transluzenten Materialien und Tiefe, Typografie (optische Größenanpassung, Laufweite, Zeilenabstand), reduzierter Bewegung oder den Design-Grundlagen (Feedback, räumliche Konsistenz, Zurückhaltung) hinter Apple-ähnlichen Oberflächen.

Was ist personal-website?

Dieser Skill zielt darauf ab, die Prinzipien des traditionellen Apple Interface-Designs – wie sie in WWDC-Vorträgen wie "Designing Fluid Interfaces" (2018) dargestellt werden – auf die Webplattform zu übertragen. Er bietet Entwicklern einen strukturierten Leitfaden, der über das bloße Kopieren von Apple-UI-Komponenten hinausgeht. Stattdessen konzentriert er sich auf die grundlegenden Konzepte von Reaktionsfähigkeit, direkter Manipulation, Unterbrechbarkeit und der Verwendung von Federn (Springs) anstelle von zeitgesteuerten Animationen. Der Skill ist für Entwickler gedacht, die mit Tools wie Claude Code, Cursor oder Codex Webanwendungen erstellen. Er enthält detaillierte Abschnitte zu Themen wie Latenzminimierung, 1:1-Verfolgung mit Zeigerereignissen, korrekter Übergabe von Geschwindigkeit beim Loslassen, Momentum-Projektion für Wurfbewegungen, Gummiband-Effekten für weiche Grenzen und der Implementierung von transluzenten Materialien mit `backdrop-filter`. Die Implementierung setzt auf Web-Standards wie `requestAnimationFrame`, Pointer Events und moderne Feder-Bibliotheken wie Motion/Framer Motion. Durch die Befolgung dieser Richtlinien können Entwickler Benutzeroberflächen erstellen, die sich weniger wie eine traditionelle Software und mehr wie eine nahtlose, physische Erweiterung des Benutzers anfühlen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CharbelElBateh/personal-website/tree/HEAD/.claude/skills/apple-design

In Ihrer bevorzugten KI fragen

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

Dokumentation

Apple Design

Erste Antwort

Wenn dieser Skill zum ersten Mal ohne eine spezifische Frage aufgerufen wird, antworten Sie nur mit:

Ich bin bereit, Ihnen zu helfen, fließende, Apple-ähnliche Oberflächen im Web zu erstellen. Mein Wissen stammt aus Apples WWDC-Design-Vorträgen, übersetzt für das Web.

Geben Sie keine weiteren Informationen, bis der Benutzer eine Frage stellt.

Wie Apple Schnittstellen baut, die aufhören, sich wie ein Computer anzufühlen, und beginnen, sich wie eine Erweiterung Ihrer selbst anzufühlen. Dieses Wissen stammt aus Apples WWDC-Design-Vorträgen – hauptsächlich Designing Fluid Interfaces (WWDC 2018) – destilliert und auf die Webplattform übertragen (CSS, Pointer Events, requestAnimationFrame, Feder-Bibliotheken wie Motion/Framer Motion).

Der rote Faden: Eine Schnittstelle fühlt sich lebendig an, wenn Bewegung vom aktuellen Bildschirmwert ausgeht, die Geschwindigkeit des Benutzers übernimmt, den Schwung nach vorne projiziert und in jedem Moment gegriffen und umgekehrt werden kann. Federn sind das Werkzeug, das all dies natürlich macht, da sie von Natur aus unterbrechbar und geschwindigkeitsbewusst sind.

Die Kernidee

"Wenn wir die Schnittstelle an die Art und Weise anpassen, wie wir denken und uns bewegen, geschieht etwas Magisches – sie hört auf, sich wie ein Computer anzufühlen, und beginnt, sich wie eine nahtlose Erweiterung von uns anzufühlen."

Eine Schnittstelle ist fließend, wenn sie sich wie die physische Welt verhält: Dinge reagieren sofort, bewegen sich kontinuierlich, tragen Schwung, widerstehen an Grenzen und können mitten in der Bewegung umgelenkt werden. Alles unten ist ein Weg, dem näher zu kommen.

Apple betrachtet Design als Dienst an vier menschlichen Bedürfnissen: Sicherheit/Vorhersagbarkeit, Verständnis, Errungenschaft und Freude. Jede Regel hier dient einem von ihnen.

1. Reaktion – Latenz töten

Sobald Verzögerung auftritt, fällt das Gefühl von Direktheit "von einer Klippe". Reaktion ist die Grundlage, auf der alles andere aufbaut.

  • Reagieren Sie beim Herunterdrücken des Zeigers, nicht beim Loslassen. Heben Sie einen Knopf in dem Moment hervor, in dem er gedrückt wird. Das Warten auf click/Berührungsende, um Feedback zu zeigen, fühlt sich tot an.
  • Seien Sie wachsam gegenüber jeder Latenz. Überprüfen Sie Entprellungen, künstliche Timer, Übergangswartezeiten und die ~300 ms Tippverzögerung. Alles auf dem Eingabepfad, das nicht wesentlich ist, ist ein Rückschritt.
  • Feedback muss während der Interaktion kontinuierlich sein, nicht nur am Ende. Für einen Drag, Schieberegler oder Drawer aktualisieren Sie die Benutzeroberfläche 1:1 mit dem Zeiger auf dem gesamten Weg – animieren Sie niemals nur, wenn die Geste abgeschlossen ist.
/* Feedback lebt auf dem Druck, und es ist sofort */
.button:active {
  transform: scale(0.97);
  transition: transform 100ms ease-out;
}

2. Direkte Manipulation – 1:1-Verfolgung

"Berührung und Inhalt sollten sich zusammen bewegen."

Wenn der Benutzer etwas zieht, muss es am Finger kleben bleiben – und den Versatz von der Stelle respektieren, an der er es gegriffen hat. Das Einrasten auf die Mitte des Elements beim Greifen zerbricht die Illusion sofort.

  • Verwenden Sie Pointer Events mit setPointerCapture, damit die Verfolgung fortgesetzt wird, auch wenn der Zeiger die Grenzen des Elements verlässt.
  • Verfolgen Sie eine kurze Geschwindigkeits-/Positionshistorie (die letzten pointermove-Ereignisse), nicht nur den aktuellen Punkt – Sie werden die Geschwindigkeit beim Loslassen benötigen.
el.addEventListener('pointerdown', (e) => {
  el.setPointerCapture(e.pointerId);
  const grabOffset = e.clientY - el.getBoundingClientRect().top; // respektieren, wo sie gegriffen haben
  // ...Position + Zeitstempelhistorie für Geschwindigkeit verfolgen
});

3. Unterbrechbarkeit – das mit Abstand wichtigste Prinzip

"Der Gedanke und die Geste finden parallel statt."

Jede Animation muss unterbrechbar und in jedem Moment umlenkbar sein. Ein Benutzer muss in der Lage sein, ein sich bewegendes Element im Flug zu greifen und umzukehren, ohne auf das Ende der Animation warten zu müssen. Ein schließendes Modal, das der Benutzer erneut greift, sollte dem Finger folgen – nicht zuerst fertig schließen und dann erneut öffnen.

  • Sperren Sie die Eingabe während eines Übergangs niemals.
  • Animieren Sie immer vom Darstellungs (aktuellen) Wert, niemals vom Zielwert. Bei einer Unterbrechung lesen Sie die Live-Bildschirmtransformation des Elements und starten die neue Animation von dort. Vom logischen/Zielwert zu starten, verursacht einen sichtbaren Sprung.
  • Vermeiden Sie CSS-Übergänge und @keyframes für alles Gestengesteuerte – sie können nicht sanft gegriffen und im Flug umgekehrt werden. Federn animieren standardmäßig vom aktuellen Wert, was genau das ist, was die Unterbrechung benötigt.
  • Wenn eine Geste umgekehrt wird, mischen Sie die Geschwindigkeit – schneiden Sie sie nicht hart ab. Das Ersetzen einer Animation durch eine andere bei einer Umkehrung erzeugt eine Geschwindigkeitsdiskontinuität, eine "Betonmauer". Federbibliotheken, die die Geschwindigkeit durch eine Neuzielsetzung tragen, vermeiden dies. (Das ist es, was iOS' additive Animationen nativ tun; wählen Sie im Web eine Federbibliothek, die mit der aktuellen Geschwindigkeit neu zielt.)
  • Zerlegen Sie 2D-Bewegung in unabhängige X- und Y-Federn. Eine einzelne Feder auf einer 2D-Entfernung desynchronisiert, wenn X und Y unterschiedliche Geschwindigkeiten haben.

4. Verhalten über Animation – Federn verwenden

"Denken Sie an Animation als ein Gespräch zwischen Ihnen und dem Objekt, nicht als etwas, das von der Schnittstelle vorgeschrieben wird."

Eine vorgeplante Animation mit fester Dauer kann nicht auf neue Eingaben reagieren. Eine Feder kann – neue Eingaben ändern lediglich das Ziel, und die Bewegung bleibt kontinuierlich. Greifen Sie zu Federn für alles, was ein Benutzer berühren kann.

Apple hat absichtlich das physikalische Trio (Masse/Steifigkeit/Dämpfung) durch zwei designerfreundliche Parameter ersetzt. Denken Sie in diesen Begriffen:

  • Dämpfungsverhältnis – kontrolliert das Überschwingen. 1.0 = kritisch gedämpft, kein Nachschwingen, sanftes Einpendeln. < 1.0 = überschwingt und oszilliert. Niedriger = schwungvoller.
  • Reaktionszeit – wie schnell der Wert das Ziel erreicht, in Sekunden. Niedriger = schneller. Dies ist nicht die "Dauer" – eine Feder hat keine feste Dauer; ihre Einschwingzeit ergibt sich aus den Parametern.

Standardwerte:

  • Starten Sie die meisten UI mit Dämpfung 1.0 (kritisch gedämpft) – anmutig und nicht ablenkend.
  • Fügen Sie Schwung (Dämpfung ~0.8) nur hinzu, wenn die Geste selbst Schwung hatte (ein Wischen, ein Werfen, ein Loslassen nach einem Ziehen). Überschwingen bei einem Menü, das gerade eingeblendet wurde, fühlt sich falsch an; Überschwingen bei einer Karte, die Sie gewischt haben, fühlt sich richtig an.

Konkrete Werte, die Apple ausliefert:

InteraktionDämpfungReaktionszeit
Bewegen / Neu positionieren (z.B. PiP)1.00.4
Drehung0.80.4
Drawer / Sheet0.80.3

Web-Mapping (Motion / Framer Motion): die bounce + duration Feder-API bildet Apples Dämpfung + Reaktionszeit gut ab. Ein sicherer Hausstil sind standardmäßig damping: 1.0-Federn; reservieren Sie Schwung für schwunggetriebene, physische Interaktionen.

import { animate } from 'motion';

// Kritisch gedämpfter Standard (kein Überschwingen)
animate(el, { y: 0 }, { type: 'spring', bounce: 0, duration: 0.4 });

// Schwung-Interaktion – ein wenig Schwung, nur weil ein Wischen vorausging
animate(el, { y: target }, { type: 'spring', bounce: 0.2, duration: 0.4 });

5. Geschwindigkeitsübergabe – die Naht zwischen Ziehen und Animation

Wenn eine Geste endet, muss die Animation mit der exakten Geschwindigkeit des Fingers fortgesetzt werden, damit es keine sichtbare Naht zwischen Ziehen und Animieren gibt. Dies ist das Detail, das "fließend" am meisten von "gut" unterscheidet.

Übergeben Sie die Loslassgeschwindigkeit des Zeigers als Anfangsgeschwindigkeit der Feder. Einige Feder-APIs benötigen relative Geschwindigkeit – normalisieren Sie sie durch die verbleibende Entfernung zum Ziel:

relativeGeschwindigkeit = GestenGeschwindigkeit / (ZielWert − aktuellerWert)

Beispiel: Element bei y=50, Ziel y=150 (100px zu gehen), Finger bewegt sich mit 50px/s → Anfangsgeschwindigkeit der Feder = 50 / 100 = 0.5. Framer Motion / Motion akzeptieren die absolute px/s-Geschwindigkeit direkt (velocity-Option), daher übergeben Sie normalerweise den Rohwert.

6. Momentum-Projektion – dorthin animieren, wo die Geste hingeht

"Nehmen Sie eine kleine Eingabe und erzeugen Sie eine große Ausgabe."

Rasten Sie nicht ab dem Loslasspunkt an der nächsten Grenze ein. Verwenden Sie die Geschwindigkeit, um die Ruheposition zu projizieren – genau wie die Scroll-Verzögerung – und rasten Sie dann am Ziel ein, das diesem projizierten Punkt am nächsten liegt. Dies ist es, was ein Wischen so wirken lässt, als würde es das Element werfen.

Apples exakte Projektionsfunktion (aus dem Beispielcode von Designing Fluid Interfaces):

// decelerationRate ≈ 0.998 für normales Scrollgefühl; 0.99 für schnelleres
function projizieren(anfangsgeschwindigkeit /* px/s */, decelerationRate = 0.998) {
  return (anfangsgeschwindigkeit / 1000) * decelerationRate / (1 - decelerationRate);
}

const projizierterEndpunkt = aktuellePosition + projizieren(loslassgeschwindigkeit);
const ziel = naechsterEinrastpunkt(projizierterEndpunkt);   // Ziel aus der Projektion wählen
springeAnimationZumZiel(ziel, { velocity: loslassgeschwindigkeit }); // dann Geschwindigkeit übergeben (§5)

Hinweis: Die Physikbuch-Formel v²/(2·decel) ist nicht, was Apple verwendet – verwenden Sie die obige Form des exponentiellen Abfalls. Dies ist das Standardverhalten bei guten Bottom-Sheets und Karussells (Vaul, Embla).

7. Räumliche Konsistenz – symmetrische Pfade, verankerte Ursprünge

"Wenn etwas auf eine Weise verschwindet, erwarten wir, dass es dort auftaucht, wo es herkam."

  • Betreten und Verlassen entlang desselben Pfades. Ein Panel, das von rechts hereinschiebt, muss nach rechts verschwinden. Von-rechts-rein / nach-unten-raus fühlt sich zusammenhanglos und verwirrend an.
  • Verankern Sie Interaktionen an ihrer Quelle. Ein Menü, Popover oder Sheet sollte von dem Element ausgehen, das es ausgelöst hat – setzen Sie transform-origin auf den Auslöser, damit die räumliche Beziehung zwischen Schaltfläche und Inhalt offensichtlich ist. (Dies ist der gleiche Ursprungs-Bewusstseins-Punkt wie bei Popovers, die von ihrem Auslöser aus skalieren, nicht von ihrer Mitte.)
  • Spiegeln Sie die Beschleunigung bei umkehrbaren Übergängen, sodass der ausgehende Pfad mit dem Rückkehrpfad übereinstimmt (verwenden Sie inverse kubische Bézier-Kontrollpunkte für die beiden Richtungen).

8. Hinweis in Richtung der Geste

Menschen sagen einen Endzustand aus einer Flugbahn voraus. Zwischenbewegungen sollten andeuten, wohin die Dinge gehen – Control Center-Module "wachsen nach oben und außen in Richtung Ihres Fingers." Lassen Sie die Zwischenbilder auf das Ergebnis zeigen, nicht nur blind dorthin interpolieren.

9. Gummiband-Effekt – weiche Grenzen

An einer Kante widerstehen Sie progressiv, anstatt hart zu stoppen. Ein harter Stopp liest sich als "eingefroren"; kontinuierlicher Widerstand liest sich als "reaktionsschnell, aber hier gibt es nichts mehr." Wenden Sie eine Dämpfung an, die zunimmt, je weiter der Benutzer über die Grenze hinaus zieht.

// Je weiter über die Grenze hinaus, desto weniger folgt das Element – echte Dinge verlangsamen sich, bevor sie anhalten
function gummiband(ueberschwingen, dimension, constant = 0.55) {
  return (ueberschwingen * dimension * constant) / (dimension + constant * Math.abs(ueberschwingen));
}

10. Geste-Design-Details (die "Feel"-Checkliste)

  • Tippen: hervorheben bei Berührungs-unten (sofort), bestätigen bei Berührungs-oben. Fügen Sie ~10px Hysterese/Trefferkissen um das Ziel herum hinzu und erlauben Sie Abbrechen durch Wegziehen und Zurückkehren.
  • Ziehen/Wischen: erfordern Sie eine kleine Bewegungsschwelle (Hysterese, ~10px), bevor Sie sich auf eine Richtung festlegen, dann 1:1 verfolgen.
  • Erkennen Sie alle plausiblen Gesten parallel ab der ersten Bewegung, brechen Sie dann die Verlierer sicher ab, sobald die Absicht klar ist. Vermeiden Sie Erkennungsmechanismen, die nur einen endgültigen Zustand melden (swipeleft-artige Ereignisse) – sie werfen die kontinuierliche Verfolgung weg, die Sie für das Feedback benötigen.
  • Minimieren Sie Verzögerungen bei der Auflösung von Mehrdeutigkeiten. Die Doppeltipp-Erkennung verzögert unvermeidlich einzelne Tipps; zahlen Sie diesen Preis nur dort, wo Doppeltipp wirklich existiert.

11. Bildgenaue Glätte

Glätte hängt davon ab, was in den Bildern ist, nicht nur von der Bildrate.

  • Halten Sie die positionsbezogene Änderung pro Bild unterhalb der Wahrnehmungsschwelle, um Stroboskopeffekte zu vermeiden.
  • Für extrem schnelle Bewegung kodiert eine subtile Bewegungsunschärfe / Streckung die Geschwindigkeit und liest sich besser als ein harter, scharfer Strich.
  • requestAnimationFrame ist die anzeigensynchronisierte Uhr des Webs (Apple verwendet CADisplayLink). Animieren Sie nur kompositorfreundliche Eigenschaften – transform und opacity – und geben Sie mit will-change einen Hinweis, wo Bewegung bevorsteht.

12. Materialien & Tiefe – Transluzenz vermittelt Hierarchie

Apple verwendet transluzente Materialien als schwebende funktionale Schicht, die Struktur bringt, ohne den Fokus zu stehlen. Nähern Sie sich im Web mit backdrop-filter an.

  • Bauen Sie Nav/Toobars/Sheets als transluzente Schichten (backdrop-filter: blur() + ein halbtransparenter Hintergrund) mit darunter scrollendem Inhalt – nicht als undurchsichtige Balken, die einen festen Streifen verbrauchen.
  • Materialgewicht kodiert Hierarchie: dunklere/schwerere Materialien trennen strukturelle Bereiche (Seitenleisten); hellere Materialien lenken die Aufmerksamkeit auf interaktive Elemente (Schaltflächen). Stapeln Sie niemals eine helle transluzente Oberfläche auf eine andere – die Lesbarkeit bricht zusammen.
  • Größere Oberflächen sollten als dicker wahrgenommen werden: stärkere Unschärfe + ein tieferer Schatten als bei kleinen Chips. Erwägen Sie kontextbewusste Schatten – schwerer über geschäftigem/Textinhalt für Trennung, leichter über einfachen Hintergründen.
  • Abdunkeln, um zu fokussieren, trennen, um den Fluss zu erhalten. Eine modale Aufgabe paart die Oberfläche mit einer abdunkelnden Abdeckung und schiebt den Hintergrund zurück/nach unten. Ein paralleles, nicht blockierendes Panel verwendet Transluzenz und Versatz ohne eine Abdeckung, damit der Fluss nicht unterbrochen wird. Für gestapelte Sheets dunkeln Sie progressive jede übergeordnete Schicht ab und schieben sie zurück.
  • Vibranz hält Text lesbar über wechselnden Hintergründen. Über unscharfen/transluzenten Oberflächen verwenden Sie kein flaches graues Text – verwenden Sie einen höheren Kontrast, ein etwas schwereres Gewicht und einen kleinen Buchstabenabstands-Boost. Setzen Sie Farbe auf eine feste Schicht, nicht auf den transluzenten Vordergrund.
  • Scroll-Rand-Effekte, keine harten Trennlinien. Anstelle eines 1px-Rands unter einer festen Kopfzeile blenden Sie eine kleine Unschärfe-/Verlaufsmaske ein, wo der Inhalt auf schwebendes Chrom trifft – nur dort, wo schwebende UI tatsächlich mit Inhalt überlappt.
  • Materialisieren, nicht nur ausblenden. Für Glas-/Unschärfe-Oberflächen animieren Sie den Unschärferadius und die Skalierung gemeinsam beim Ein-/Ausgang, sodass die Oberfläche als ein reales ankommendes Material wahrgenommen wird, nicht als eine einfache Deckkraft-Überblendung.
.toolbar {
  background: rgba(255, 255, 255, 0.6);
  backdrop-filter: blur(20px) saturate(180%);
  border-top: 1px solid rgba(255, 255, 255, 0.4); /* helle Oberkante = Licht, das auf das Material trifft */
}

13. Multimodales Feedback – Bewegung + Ton + Haptik

Drei Regeln für die Kombination der Sinne (aus Designing Audio-Haptic Experiences):

  1. Kausalität – es muss offensichtlich sein, was das Feedback verursacht hat. Lösen Sie es beim tatsächlichen kausalen Ereignis aus (dem Umlegen des Kippschalters, dem Einrasten des Elements) und passen Sie seinen Charakter an die Physis der Aktion an.
  2. Harmonie – das Visuelle, das Ton und die Haptik müssen im gleichen Bild ausgelöst werden. Latenz zwischen ihnen zerstört die Illusion. Lassen Sie nicht zu, dass ein ...

Individual skills in this repo

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

CharbelElBateh/personal-website

Build animations in React Native and Expo, making the decisions in the order that determines whether they feel right — should it animate, which thread it runs on, which properties, spring or timing, how the gesture hands off, how it degrades. Writes the implementation with Reanimated, Gesture Handler, Expo Router and expo-haptics. Use when animating anything in an Expo app, adding gestures, sheets, screen transitions, press feedback or haptics, or fixing motion that stutters on device. For web animation use `animate`.

CharbelElBateh/personal-website

Build an animation from scratch, making the decisions in the order that determines whether it feels right — should it animate at all, what purpose, which tool, which properties, which curve and duration, how it interrupts, how it exits. Writes the implementation. Use when asked to animate something, add motion, make a component feel alive, or build a transition. For critiquing existing motion use review-animations; for auditing a whole codebase use improve-animations.

CharbelElBateh/personal-website

Reverse-lookup glossary that turns a vague description of a web animation or motion effect into its exact term ("the bouncy thing when a popover opens" → Pop in; "the iOS rubber-band scroll" → Rubber-banding). Use when the user asks "what's it called when…", or describes a motion effect without knowing its name and wants the right word to prompt an AI or designer with. For naming an effect, not designing or building one.

CharbelElBateh/personal-website

Guide to Sonner, the React toast library — install and wire up the Toaster, pick the right toast() call, promise and loading toasts, updating, dismissing and persisting toasts, styling, theming and icons, positioning and multiple toasters. Use when working with Sonner or troubleshooting it — toasts that don't appear, appear twice, lose their styles, ignore Tailwind classes, sit behind a modal, or don't follow dark mode.

CharbelElBateh/personal-website

Try to break a piece of UI by feeding it worst-case data — long names, unbreakable emails, one-letter names, missing fields, huge counts, zero items, long labels, non-Latin text, emoji, extreme numbers — then render it behind a "Demo data / Worst case" toggle and report everything that broke, with the fix for each. Use when the user asks to stress-test, break, or find edge cases in a component or screen, or to "try the worst case". For visual design critique use emil-design-eng; for motion use review-animations.

CharbelElBateh/personal-website

This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.

CharbelElBateh/personal-website

Search a codebase or UI for places that don't animate but should, and reject everything that shouldn't. Read-only; it proposes motion with exact values, it does not implement it. Use when the user asks "what could be animated here?" or wants to "make this feel more alive". For fixing existing animations, use improve-animations or review-animations instead.

CharbelElBateh/personal-website

Survey a codebase's animation and motion code as a senior motion advisor, then produce a prioritized audit and self-contained implementation plans for other agents (or cheaper models) to execute. Read-only on source code — it plans improvements, it does not apply them. Use when the user asks to "improve the animations", "audit the motion", "make this app feel better", or wants a roadmap of animation fixes rather than a review of a single diff.

CharbelElBateh/personal-website

Make a web app feel native on a phone — the small CSS and meta-tag fixes that separate "a website in a browser" from something that feels installed. Covers sticky hover states, tap highlight flashes, the 100vh bug, inputs that zoom the page, laggy taps, pull-to-refresh hijacking scroll, content under the notch, long-press selecting button text, carousels that scroll the wrong way, mismatched status bars, and the rule that you test on real hardware. Use when a web app is being built for or reviewed on mobile, when something "works in Chrome but feels wrong on my phone", when building a PWA, a bottom sheet, a carousel, a full-screen layout, or any touch interaction. For motion itself use animate; for React Native use animate-expo.

CharbelElBateh/personal-website

Pick the right library for a given frontend task from a curated, opinionated list — numbers, OTP inputs, charts, command menus, virtualization, drag and drop, toasts, state, styling, and more. Only runs when explicitly invoked; it does not trigger on its own.

CharbelElBateh/personal-website

Build multiple genuinely different versions of a UI piece you describe, rendered behind a visual picker so you can flip through them live and promote the one that feels right. Only runs when explicitly invoked; it does not trigger on its own.

CharbelElBateh/personal-website

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

CharbelElBateh/personal-website

How to write modern Swift well — modeling with value types, Swift 6 data-race safety and approachable concurrency (@concurrent, main-actor-by-default, actors, task groups), protocols and generics (some vs any), API design, performance and ARC, Swift Testing, macros, and the modern language features agents don't know about yet. Use when writing, reviewing, or migrating Swift, or when a concurrency error, a hang, a data race, a retain cycle, or a performance problem needs fixing.

Verwandte Skills