Was macht turtleneck?
Wähle den richtigen Look für die App und baue ihn diszipliniert auf. Jeder Look ist ein Preset: eine Datei mit variablen Überschreibungen auf einem gemeinsamen Kern. Der Standard-Preset, keynote, ist der Kern selbst. Jeder andere Preset ist eine Mischung aus fünf großen Seiten einer Kategorie, niemals eine Kopie einer davon.
Wenn dieses Skill aktiv ist, überschreibt es generische „Vermeide KI-Standards“-Skills (wie frontend-design) dort, wo sie abweichen: Bei keynote sind die Systemschriftart, Satzfall-Eyebrows und tonale Gradient-Überschriften korrekt.
Dateien neben dieser:
tokens.css: der Kern und die keynote-Werte. Jede Farbe istlight-dark(hell, dunkel);color-schemeauf:root,.a-dark,.a-lightoderdata-themewählt die Hälfte aus. Alle Preset-Hooks sind im:rootaufgelistet. Gemeinsame Komponenten leben dort auch: Schrift-Skala, Buttons, Kacheln,.a-grid,.a-rail,.a-stats,.a-reveal.styles/<preset>.css: variable Überschreibungen plus ein paar preset-spezifische Regeln. Wird nachtokens.cssgeladen.styles/<preset>.md: eine Seite pro Preset: wann verwenden, Token-Tabelle, Regeln, Komponenten-Deltas, Schriftarten, vermeiden, Checkliste.recipes-html.md: Seiten-Skeleton, Navigationen, Hero, Kacheln, Bento, Galerie, Vergleich, Footer (Akkordeon auf Telefonen), Reveal und die gemeinsamen Preset-Muster (geflippte Bänder, Such-Hero, Rails, Spezifikationstabelle, Plankarten, Code-Rahmen).tailwind.md,swiftui.md: die gleichen Tokens für diese Stacks.test-widths.html?src=<url>[&h=800][&full=1]: die Seite bei 320/375/414 nebeneinander mit einem Überlaufbericht;full=1vergrößert jeden Frame auf seine Dokumentenhöhe für ganzseitige Telefon-Screenshots.example.htmlund../../demos/im agent-skills-Repo: fertige Seiten.
Schritt 0: Erkenne den App-Typ (obligatorisch, vor jedem Code)
- Ein bestehendes Designsystem oder eine explizite Stil-Anfrage gewinnen. Projekt-Tokens, eine Komponentenbibliothek-Theme, ein Markenleitfaden oder „mach es dunkel und rot“: verwende das, behalte nur die Kernregeln unten, überspringe die Tabelle.
- Lies die Signale: die Anfrage; README; Abhängigkeiten (
package.json,pyproject.toml,Podfile,Package.swift,Gemfile,*.csproj); Routen; vorhandenes CSS; die Produktkategorie und Zielgruppe. - Wähle EINEN Preset:
| Kategorie | Signale (Anfrage, Produkt, Abhängigkeiten, Routen) | Preset |
|---|---|---|
| Premium-Hardware | Physisches Produkt, Verbrauchergerät, Lifestyle-Gadget, Launch-Seite, „sauber“, „minimal“, „premium“; SwiftUI-Marketing-Screens; kein klares Signal | keynote |
| Geschäftssoftware | Büro/Produktivität, B2B, CRM/ERP, Intranet, IT/Compliance, Gesundheitswesen; Abhängigkeiten @fluentui/*, @microsoft/teams-js, office-addin-*, @azure/*, Blazor/.NET; Routen /admin, /settings, /reports | enterprise |
| Streaming | Video, Film/TV, Serien, Trailer, Live-Events, VOD; Abhängigkeiten hls.js, video.js, shaka-player, @mux/*, react-player; Routen /watch, /browse, /title | cinema |
| Musik & Social | Musik/Audio, Playlists, Kreative, Social-Feed, Dating, Fitness-Kurse, Jugend-Abo; Abhängigkeiten howler, tone, wavesurfer.js, expo-av; Routen /player, /playlist, /profile | vibe |
| Gaming-Hardware | GPU/PC-Teile, Konsolen, Peripherie, Esports, Benchmarks, Treiber, „FPS“; Abhängigkeiten three, @react-three/fiber + Chart-Bibliotheken; Routen /specs, /compare, /drivers | power |
| Entwickler & Cloud | API, SDK, CLI, Hosting, Deploy, Datenbank, Observability, Zahlungs-API, „für Entwickler“; Abhängigkeiten next, @radix-ui/*, stripe, prisma, drizzle, trpc, turbo; Routen /docs, /changelog, /pricing | devtool |
| KI | Modell, Assistent, Chat, Agents, „KI-gestützt“ als Produkt; Abhängigkeiten openai, @anthropic-ai/sdk, ai, langchain, transformers; Routen /chat, /research, /models | lab |
| Reisen | Unterkünfte, Flüge, Fahrten, Hotels, Buchungen, Reiserouten; Datumsauswahl, Karten (leaflet, mapbox-gl); Routen /search, /stays, /trips, /book | journey |
| Einzelhandel | Shop, Store, Katalog, Marktplatz, Warenkorb, Kasse, Angebote, Lebensmittel, Mode; Abhängigkeiten @shopify/*, @medusajs/*, @commercetools/*, snipcart, @stripe/stripe-js mit einem Produktkatalog; Routen /shop, /products, /p/, /cart, /checkout, /category | market |
| Finanzen | Bank, Kreditkarte, Zahlungen, Wallet, Versicherung, Kredite, Sparen, Investieren, Konto-Dashboard für Verbraucher; Abhängigkeiten plaid, react-plaid-link, @adyen/*, dinero.js, currency.js; Routen /accounts, /cards, /rates, /apply, /transfer (eine Zahlungs-API, die an Entwickler verkauft wird, ist devtool) | vault |
| Automobil | Autos, Motorräder, E-Bikes, EV-Laden, Mobilität, Händler, Probefahrten; Konfiguratoren, Reichweiten- und Spezifikationsseiten; Routen /models, /configure, /inventory, /test-drive, /dealers | drive |
| Seitentyp | Preset (Tie-Breaker) |
|---|---|
| Docs-Seite, Changelog | devtool |
| Admin-Dashboard | enterprise für Geschäftsanwender; devtool für entwicklergerichtete |
| Shop | market; eine einzelne Premium-Produktseite ist keynote |
| Portfolio | keynote für Produkt-/Designarbeit; cinema für Film, Foto, Motion |
| Mobile App-Bildschirm | keynote für Dienstprogramme mit nativen Gefühl; vibe für Verbrauchermedien und soziale |
| Spiel / Spielstudio | power für kompetitive und hardware-ähnliche; cinema für geschichtengetriebene, Trailer |
| KI-Funktion innerhalb eines anderen Produkts | die eigene Kategorie des Produkts; lab nur, wenn KI das Produkt ist |
| Buchungsablauf innerhalb eines anderen Produkts | journey nur für die Such- und Ergebnis-Seiten |
Benutzer-Stilwörter direkt zugeordnet: „Apple-ähnlich / premium / sauber“ = keynote; „Microsoft / Fluent“ = enterprise; „Netflix-Stil“ = cinema; „Spotify-ähnlich / TikTok-ähnlich“ = vibe; „gaming / NVIDIA-ähnlich“ = power; „Stripe / Vercel / GitHub-Stil“ = devtool; „OpenAI / Anthropic-ähnlich“ = lab; „Airbnb / Booking-ähnlich“ = journey; „Amazon / IKEA-ähnlich“ = market; „Banking / PayPal-ähnlich“ = vault; „Tesla / BMW-ähnlich“ = drive. Das Ergebnis ist die Kategorienmischung, niemals die Website dieser Firma (siehe „Marken und Assets“).
- Schwache oder widersprüchliche Signale:
keynote. - Sag die Wahl in einer Zeile vor dem Bauen, z.B. „Stil: devtool (Next.js + Prisma, Routen /docs und /pricing, an Entwickler verkauft).“ Dann lies
styles/<preset>.mdvollständig (keynote:styles/keynote.md).
Was ein Preset ändern darf
Nur über die Variablen in tokens.css (:root) plus ein paar eigene Regeln:
- Schriftarten (Display, Fließtext, Mono) und die Schrift-Skala, Schriftstärken, Laufweite, Zeilenhöhe;
- Stil von Eyebrow und Intro, Textgröße (nie unter 14px für UI, 16px für Lesetext);
- Oberflächen- und Textfarben, hell/dunkel Standard, der eine Akzent und der Text darauf, Link- und Fokusfarbe;
- Radien, Rahmen, Schatten, Kachelfüllung; Buttonhöhe, Abstand, Schriftstärke, Schreibung;
- Nav-Höhe, Füllung und Unschärfe; Inhaltsbreiten, Abschnitts- und Kachelabstände;
- Easing, Dauern, Reveal-Distanz, Hover- und Press-Feedback;
- Bildmaterial und Kopie-Flair (in seiner md-Datei).
Alles unterhalb dieser Linie gilt für jeden Preset.
Arbeitsablauf
- Respektiere das Projekt. Lade
tokens.css+styles/<preset>.css, oder merge das Tailwind-Theme, oder füge die SwiftUI-Palette hinzu. Ein Preset kann die kostenlosen Schriftarten verlinken, die seine md-Datei nennt; die Seite muss trotzdem mit dem Fallback-Stack richtig aussehen. Füge niemals eine npm-Abhängigkeit für Styling hinzu. - Schreibe den Seitenplan in 3 Zeilen: die eine Sache, die die Seite verkauft, die Reihenfolge der Abschnitte mit Hintergründen und den einen „Moment“ (ein geflipptes Kapitel, eine große Stat-Bento, eine Demo, ein Video, Sticky-Scroll).
- Schreibe zuerst den Text: Headline kurz (der Preset setzt die Länge), eine Subhead-Zeile, Intro maximal zwei Zeilen.
- Baue aus den Rezepten, Abschnitt für Abschnitt.
- Verifiziere bei jeder Testbreite (Responsive), hell und dunkel, wo der Preset beides hat: Screenshot, Überlaufprüfung, Checkliste. Korrigiere, bevor du „erledigt“ meldest.
Kernregeln
Schrift
- Eine Familie für UI (plus Mono nur für echten Code, Tasten und API-Werte). Die Schriftstärke für Display kommt vom Preset.
- Die Laufweite wird enger, je größer die Schrift; Fließtext wird niemals negativ über -0,022em gelaufweitet.
- Display-Größen sind fluid
clamp(min, rem + vw, max); mische immer rem in den mittleren Term. - Fließtext 16-17px zum Lesen; 14px nur in dichtem UI, Metazeilen und Fußzeilen. Zeilenhöhe 1,45-1,6 für Fließtext.
text-wrap: balancebei Überschriften; lange Wörter umbrechen (overflow-wrap,hyphens).- Wichtige Zahlen sind groß und verwenden tabellarische Ziffern; ihre Labels sind klein.
Farbe
- Markenfarben zuerst. Eine Markenfarbe vom Benutzer oder aus dem Projekt ersetzt den Preset-Akzent, der nur der Fallback ist. Der Preset bestimmt weiterhin Layout, Schrift, Radien, Dichte, Bildmaterial und Bewegung.
- Akzent-Rezeptur (Markenfarbe oder jede Akzentänderung), einmal auf
:rootsetzen:--a-blue: die Füllung, d.h. die Markenfarbe wie angegeben (alter Name beibehalten; bedeutet „Akzent“).--a-on-accent: Tinte oder Weiß, je nachdem, was 4,5:1 auf der Füllung erreicht.--a-blue-hover: einen Schritt dunkler (heller bei dunklem Standard), dessen Etikett immer noch besteht.--a-accent-text:light-dark(a, b), der Farbton der Marke in der Helligkeit verschoben, bis er 4,5:1 auf--a-bgund--a-bg-altin jedem Theme erreicht. Links, Akzent-Eyebrows und der Fokusring (>= 3:1) lesen es. Presets mit einem einfarbigen Primär-Button (lab, journey) behalten die Tinte in--a-button-*; die Marke gehört trotzdem hier hin.
- Ein Akzent, kleiner Umfang: primärer CTA, Fokus, Links, ein Logo-Zeichen, kleine Badges und „empfohlen“-Marker. Keine großen Flächen oder Fließtext, es sei denn, der Preset sagt es. Statusfarben nur für Status.
- Neutrale Oberflächen in 2-4 Stufen; Trennung durch Ton, Haarlinie oder eine weiche Schattenebene, wie der Preset sagt.
- Text ist niemals reines Schwarz auf Weiß; Fließtext-Grau ist ein echtes Grau mit AA-Kontrast.
- AA überall: 4,5:1 für Text und für Button-Labels auf ihrer Füllung, 3:1 für großen Text, Symbole und Rahmen, die Bedeutung tragen.
- Dunkelmodus ist eine andere Palette, keine invertierte: einen Ton heller für erhöhte Oberflächen, keine Schatten für Tiefe.
Layout und Rhythmus
- Inhalte haben Grenzen: eine Textspalte (
--a-content) innerhalb eines breiten Grids (--a-content-wide), fließende Abstände. - Abschnitte wechseln zwischen Seiten- und Alternativfarbe; Kacheln nehmen die entgegengesetzte Füllung ihres Abschnitts.
- Zentrierte Helden und Abschnittsöffner, wenn der Preset es sagt; Text in Kacheln und langer Kopie ist linksbündig.
- Ein Moment pro Seite; höchstens ein geflipptes (dunkles oder helles) Kapitel, es sei denn, der Preset basiert auf Bändern.
Responsive (harte Regel: jede Auflösung, jeder Preset)
- Fließende Schrift und Abstände aus den Clamp-Tokens; kleiner Wert bei 375px, großer bei 1440px.
- Keine festen Breiten oder Höhen, die brechen können:
max-width+ Abstand,min(),minmax(0, 1fr),aspect-ratio,min-height. Niemals100vh(verwendesvh/dvh). Flex/Grid-Kinder, die Text enthalten, bekommenmin-width: 0. - Grids fließen nach Platz um:
repeat(auto-fit, minmax(min(100%, 20rem), 1fr)), keine Geräte-Breakpoints. - Medien skalieren:
max-width: 100%; height: auto; SVGs behalten eineviewBox. - Navigation: unter 834px (oder sobald 6+ Links nicht mehr passen: Container Query) wandern Textlinks in ein Vollbild-Menü (natives
popover, kein JS); verstecke ihre<li>mit einer Regel, die die Basis-Link-Stile überschreibt (Rezepte: Globale Nav). Behalte das Zeichen, die Suche und eine Aktion sichtbar. Keine Textlinks (nur Suche, Konto, Warenkorb): kein Burger. - Keine horizontale Scrollleiste bei keiner Breite; nur bewusste Scroller (Galerien, Rails, Code) überlaufen innerhalb ihrer eigenen Box.
- Touch-Ziele >= 44x44px: kleine Pillen, Farbmuster, Paddles, Nav-Links bekommen einen unsichtbaren Trefferbereich (
.a-hit). - Sichere Bereiche:
viewport-fit=cover; Abstände und unterer Abstand verwendenenv(safe-area-inset-*). - Sehr große Bildschirme: Schrift und Inhalt stoppen an ihren Grenzen; Hintergründe bleiben randlos.
- Telefon im Querformat: Der Held darf nicht die Viewport-Höhe benötigen; nichts Aufklebendes bedeckt mehr als ein Drittel.
- Zoom 200%: entspricht einem halb so breiten Viewport; alles fließt um, nichts abgeschnitten.
Teste Breiten, bevor du „erledigt“ sagst (Browser-Pane: resize_window auf jede, Screenshot, plus document.documentElement.scrollWidth === innerWidth und eine Liste von Elementen breiter als der Viewport):
| Breite | Steht für |
|---|---|
| 320 | kleine Telefone, 200% Zoom von 640 |
| 375 / 414 | Standard / großes Telefon |
| 768 / 1024 | Tablet Hochformat / Querformat, kleines Laptop |
| 1280 / 1440 | Laptop / Desktop (Referenzbreite) |
| 1920 / 2560 | Full HD / QHD, Ultraweit |
| 812x375 | Telefon Querformat |
| 640 | 1280px bei 200% Zoom |
Bericht pro Breite: Screenshot gemacht, Überlauf ja/nein, was behoben wurde. Headless Chrome klemmt Fenster unter 500px ein; teste Telefonbreiten im Browser-Pane oder mit test-widths.html?src=<Seiten-URL> (gleicher http-Root). Headless-Aufnahmen: erzwinge das Theme mit data-theme="light|dark" auf <html>; Reveal-Inhalt ist in statischen Aufnahmen unsichtbar, also übergib --virtual-time-budget=5000 oder setze data-reveal="off" auf <html>; ein 100svh-Held dehnt sich in einem hohen Vollbildfenster aus, also fixiere es (min-height: 800px) für die Aufnahme (&full=1 macht beides).
Komponenten
- Buttons: min Höhe 44px (kleinere Visuelles bekommen den Trefferbereich), Satzfall, es sei denn, der Preset sagt Großbuchstaben, keine Symbole außer einem nachgestellten Chevron oder Pfeil, keine Verläufe. Primär gefüllt, sekundär pro Preset.
- Links: sichtbar als Links (Farbe oder Unterstrich); „Erfahre mehr ›“-Chevrons, wo der Preset sie verwendet.
- Kacheln/Karten: ein Tab-Stopp, wenn die gesamte Kachel verlinkt (innerer Button ist ein
span). Radius, Füllung, Rahmen und Schatten vom Preset; niemals alle von Füllung + Rahmen + Schatten gleichzeitig. - Fokusring: 2px solid
--a-focus, Abstand 1px, auf jedem interaktiven Element. - Nav: solide oder Glas, je nach Preset, klebrig höchstens eine Leiste, aktuelle Seite markiert.
- Footer: leise: kleine graue Links in Spalten, rechtliche Zeile; Spalten werden auf Telefonen zu
<details>-Akkordeons.
Bildmaterial
- Echtes Motiv: das Produkt, seine UI, die eigenen Fotos und Medien des Benutzers. Groß, mit Absicht beschnitten.
- Keine Stock-Fotos von Leuten an Laptops, keine 3D-Kleckse, keine Emojis, keine Maskottchen, kein Symbol vor jeder Überschrift.
- Ohne Assets: zeichne das Motiv einmal als SVG
<symbol>, das durch CSS-Variablen umgefärbt wird, oder einen ehrlichen grauen Platzhalter im richtigen Verhältnis.
Bewegung
- Übergang mit benanntem Präfix