Promptory Web Build
Drei Werkzeuge, ein Stack, jedes mit einer Aufgabe:
| Werkzeug | Rolle | Faustregel |
|---|---|---|
| Lenis | Scroll-Engine — sanftes, träges Scrollen über dem nativen Scroll | Einmal global installiert. Niemals pro Abschnitt. |
| GSAP (+ ScrollTrigger) | Animations-Engine — benutzerdefinierte Zeitlinien, scrollgesteuerte Animation, Pinning | Alles, was für das Design dieser Website spezifisch ist. |
| React Bits | Fertig animierte Komponenten (Text, Hintergründe, Cursor, Karten, Buttons) | Zuerst darauf zugreifen, wenn eine Katalogkomponente den Effekt bereits abdeckt. |
Sie teilen sich eine Animationsschleife: GSAPs Ticker treibt Lenis an, und ScrollTrigger liest Lenis' Scrollen. Diese Verdrahtung korrekt hinzubekommen, ist das Wichtigste an dieser Skill (§3).
Geltungsbereich: nur Echtzeit-Web/DOM. Für Videorendering (Remotion, Reels) gilt diese Skill nicht.
0. Goldene Regel — kein Redesign
Setze das Design und die Effekte um, die der Benutzer angefordert hat. Ändere nicht eigenmächtig Layout, Farben, Schriftarten, Abstände oder Text, und füge keine zusätzlichen Abschnitte oder „Bonus“-Effekte hinzu, die niemand angefordert hat. Wenn ein Effekt oder eine Korrektur etwas offensichtlich verbessern würde, schlage es in einem Satz vor und warte auf ein Ja. Bewegung und Qualitätsprüfungen sollen dem bestehenden Design dienen, nicht es ersetzen.
0.5 Aufnahme-Fragebogen — ERSTER Schritt bei jeder neuen Website-Anfrage
Bevor du Code für eine neue Website schreibst, führe den Aufnahme-Fragebogen in references/intake-questionnaire.md aus:
- Lies die Anfrage und überspringe bereits Beantwortetes.
- Stelle die verbleibenden Fragen in bis zu 3 kurzen Runden (Projekt → Bewegung → Lieferung). Verwende das
AskUserQuestion-Tool von Claude Code, wenn verfügbar (anklickbare Optionen + automatisches „Sonstiges“-Freitextfeld); gib andernfalls jede Runde als einen Codeblock mit Buchstabenoptionen und einer leeren Zeile „✎ أخرى“ bei jeder Frage aus. - Zeige die Projektübersicht in einem Codeblock an und warte auf das Go.
- Baue dann, wobei du die Antworten genau befolgst.
Wenn der Benutzer „ابدأ على طول“ / „überspringen“ sagt, verwende die ⭐-Standardwerte und gib sie in der Übersicht an. Bei kleinen Änderungen an einer bestehenden Website überspringe den Fragebogen, es sei denn, die Anfrage ist mehrdeutig.
Die Übersicht muss festhalten: Sprache und Richtung (Arabisch/RTL, Englisch/LTR oder beides), das Barrierefreiheitsziel (Standard WCAG 2.2 AA), die Formulare und ihr Backend sowie das Analysetool, falls vorhanden.
0.6 Visuelle Referenzen — Prompt Motion
https://prompt-motion.com/ ist die visuelle Bibliothek für Bewegungsrichtung (Kinetischer Text, Produkt-UI, Partikel, Formen, Diagramme …, jeweils mit dem zugrunde liegenden Prompt). Verwende sie nur, wenn der Benutzer nach Inspiration fragt, im Fragebogen „benötigt einen Vorschlag“ / „gewagte Bewegung“ auswählt oder einen Link daraus teilt. Übernimm die Bewegungsidee, baue sie mit GSAP / Lenis / React Bits nach und behalte das Design des Kunden bei. Arbeitsablauf, Kategorie->Komponenten-Zuordnung und die Bewegungsspezifikationsvorlage: references/visual-references.md.
0.7 Qualitätsbarriere — bevor du etwas zeigst, prüfe
Scanne den Build auf die generischen Output-Merkmale (Standard-Indigo-Akzent, Emoji-Symbole, erfundene Metriken, Lorem Ipsum, Vorlagenabschnitte). Korrigiere, was in deinem eigenen Code ist; schlage eine einzeilige Korrektur für alles vor, was im Design des Kunden ist. Vollständige Liste: references/quality-bar.md.
0.8 Designrichtung — jede Website sieht anders aus
Wenn der Kunde kein eigenes Design hat, wähle vor dem Schreiben von Code eine Richtung. Lese references/design-styles.md und:
- Kurzliste von drei Richtungen aus dem Eignungsleitfaden für die Branche und das Publikum der Aufgabenstellung.
- Überspringe jede Richtung, die in den letzten drei Websites in diesem Chat oder Projekt verwendet wurde (Stilprotokoll).
- Schreibe eine Zeile in die Projektübersicht:
Richtung: <Name> — <Warum>, mit einer Alternative. - Baue mit den charakteristischen Entscheidungen dieser Richtung und führe dann die Abwechslungsprüfung durch: Mindestens vier von sechs Achsen müssen sich von der vorherigen Website unterscheiden.
Die Richtungen sind Referenzen für Struktur und Gefühl. Kopiere niemals die Marke, Fotos, den Text oder das exakte Layout einer Referenz. Wenn der Kunde ein Design liefert, befolge es und überspringe diesen Schritt (§0 goldene Regel).
0.9 Ausdrucksstarkes visuelles Design (wenn die Aufgabenstellung es offen lässt)
Quelle: anthropics/skills, Skill frontend-design (Apache-2.0, siehe deren LICENSE.txt). Gilt nur, wenn die Aufgabenstellung die visuelle Richtung offen lässt. §0 hat Vorrang: Befolge das Design des Kunden und den Wortlaut der Aufgabenstellung, auch wenn die Aufgabenstellung nach einem der unten aufgeführten Looks fragt.
- Identifiziere zuerst das Thema: Produkt, Zielgruppe, primäre Aufgabe. Wenn die Aufgabenstellung es nicht sagt, schlage eines vor und bestätige es. Branche und Materialien sind die Quellen für unverwechselbare Entscheidungen.
- Der Hero beginnt mit dem charakteristischsten Element in der Welt des Themas (Überschrift, Bild, Live-Demo oder Interaktion). Vermeide die Standardkombination aus einer großen Zahl, einem kleinen Label und einem Farbverlaufsakzent, es sei denn, es ist eindeutig die beste Option.
- Schrift: eine Familie oder zwei, die sich deutlich unterscheiden. Lege eine klare Schriftgrößenskala fest. Bei Überschriften ist die Schriftbehandlung Teil des Designs.
- Zeilenlänge unter 80 Zeichen. Serifenloser Fließtext benötigt etwas mehr Zeilenabstand als serifenloser.
- Vermeide typografische Erkennungsmerkmale: ein kursives oder farbiges Wort in einer Überschrift, Großbuchstaben-Labels und Labels über Überschriften, die nichts hinzufügen.
- Nummerierte Markierungen (01 / 02 / 03) nur, wenn der Inhalt wirklich eine Abfolge ist.
- Bewegung: ein orchestrierter Moment (Seitenladevorgang oder eine Einblendung). Kein Ein- und Ausblenden in jedem Abschnitt, keine Hover-Transition auf jeder Karte. Bewegung, die auf eine Benutzeraktion reagiert (Öffnen, Erweitern, Bestätigen), ist in Ordnung.
- Plane vor dem Code: 4–6 benannte Hex-Farben, Schriftrollen, ein Layoutkonzept (ASCII-Plan erlaubt) und Prinzipien. Überprüfe den Plan anhand der Aufgabenstellung. Wenn ein Teil wie die Standardvorgabe für eine beliebige ähnliche Seite wirkt, überarbeite ihn und sage, was sich geändert hat.
- Standard-Looks, die vermieden werden sollten, es sei denn, die Aufgabenstellung fordert sie: cremefarbener Hintergrund mit Terrakotta-Akzent; fast schwarz mit neongrünem oder zinnoberrotem Akzent; Zeitungsstil mit dünnen Linien und null Radius; identische abgerundete SaaS-Karten mit einem Radius und einem grauen Schatten; GROSSBUCHSTABEN-Augenbraue über jeder Überschrift; Mittelpunkt-Meta-Strings ('A · B · C'); 'WORT — Fragment'-Labels; #0B0B0B oder #111 als schwarzer Ersatz; Monospace für kleine Labels; '→' auf jedem Link.
- Setze Kühnheit an einer Stelle ein. Halte alles andere ruhig. Entferne Dekoration, die der Aufgabenstellung nicht dient.
- Qualitätsuntergrenze: responsiv für Mobilgeräte, sichtbarer Fokus, reduzierte Bewegung respektiert, zugänglicher Kontrast.
- Achte auf CSS-Selektorspezifität, insbesondere bei Abständen zwischen Abschnitten, wo sich Regeln gegenseitig aufheben.
- Text: schlichte Worte für den Endbenutzer, aktive Stimme, Satzfall. Behalte ein Verb durch einen Ablauf bei („Veröffentlichen“ führt zu „Veröffentlicht“). Fehler sagen, was passiert ist und wie man es behebt, ohne Entschuldigung. Leere Zustände laden zur nächsten Aktion ein.
1. Entscheidungsablauf — welches Werkzeug für welche Anfrage
- Arabische, zweisprachige oder RTL-Website → lese
references/rtl-arabic.md, bevor du ein Layout schreibst. Die Richtung ist strukturell; nachträgliches Anpassen ist teuer. - Sanftes Scrollen irgendwo auf der Website → Lenis (globaler Anbieter, §3). Führe es einmal bei der Projekteinrichtung durch, wenn es Scroll-Animationen gibt.
- Gibt es eine React Bits-Komponente, die den Effekt bereits ausführt? → überprüfe
references/react-bits-catalog.md→ installiere sie (§4). Typische Treffer: Split/Blur/Scramble-Text, Scroll-Reveal-Text, animierte Hintergründe (Aurora, Partikel, Gitter, Shader), benutzerdefinierte Cursor, Magnet/Neige-Karten, Laufbänder, Galerien, Dock/Menüs, animierte Buttons/Zähler. - Effekt ist spezifisch für dieses Design (Hero-Intro-Sequenz, gepinnter Storytelling-Abschnitt, horizontaler Scroll-Abschnitt, synchronisierte Multi-Element-Einblendungen) → GSAP-Timeline / ScrollTrigger (§5, vollständige Details in
references/gsap.md). - Projekt ist NICHT React (reines HTML/Vanilla) → React Bits ist nicht verfügbar; verwende nur Lenis + GSAP (
assets/vanilla-setup.js). - Jegliches Formular, Liste, Buchung oder datengesteuerter Abschnitt →
references/forms-and-states.md(Labels, Fehler, fünf Zustände). - Auswahl eines Drittanbieterdienstes (Schriftarten, Formular-Backend, Analytics, Hosting, Bilder) →
references/free-services.md, dann aktuelle Grenzen überprüfen. - Neue Website ohne Kundendesign → wähle zuerst eine Richtung (§0.8,
references/design-styles.md).
2. Installation
npm install gsap @gsap/react lenis
@gsap/react→ nur für React-Projekte (bietetuseGSAP).lenis/reactundlenis/snapsind inlenisenthalten — keine zusätzlichen Pakete.- Alle GSAP-Plugins (ScrollTrigger, SplitText, Flip, ScrollSmoother, Draggable…) sind in
gsapenthalten. - React Bits-Komponenten werden einzeln über die CLI hinzugefügt (§4); einige ziehen ihre eigenen Abhängigkeiten nach sich (
motion,three,ogl,matter-js…) — die CLI installiert sie, aber überprüfe die Abhängigkeitsspalte im Katalog, bevor du dich entscheidest, um das Bundle nicht aufzublähen.
Verwende GSAPs ScrollSmoother niemals zusammen mit Lenis — sie sind zwei konkurrierende sanfte Scroll-Engines. Lenis ist die Scroll-Engine in diesem Stack.
3. Verdrahtung von Lenis + GSAP + ScrollTrigger (führe dies exakt aus)
React / Next.js
Kopiere assets/SmoothScroll.jsx in das Projekt (z. B. components/SmoothScroll.jsx) und umschließe die App einmal:
// app/layout.jsx (Next.js App Router)
import SmoothScroll from '@/components/SmoothScroll';
import ScrollToTopOnRoute from '@/components/ScrollToTopOnRoute';
export default function RootLayout({ children }) {
return (
<html lang="en">
<body>
<SmoothScroll>
<ScrollToTopOnRoute />
{children}
</SmoothScroll>
</body>
</html>
);
}
Für Arabisch setze lang und dir basierend auf dem Gebietsschema auf <html> (siehe references/rtl-arabic.md §1).
Für Vite/React umschließe <App /> in main.jsx auf die gleiche Weise und überspringe ScrollToTopOnRoute (es verwendet next/navigation).
Was der Anbieter tut — und warum jede Zeile wichtig ist:
<ReactLenis root options={{ autoRaf: false }}>→ eine globale Instanz auf<html>;autoRaf: false, weil GSAP es antreiben wird.lenis.on('scroll', ScrollTrigger.update)→ ScrollTrigger berechnet bei jedem sanften Scroll-Frame neu. Fehlt dies = Animationen werden zu spät / an falschen Positionen ausgelöst.gsap.ticker.add(t => lenis.raf(t * 1000))→ eine gemeinsame Schleife (GSAP-Zeit ist in Sekunden, Lenis möchte ms).gsap.ticker.lagSmoothing(0)→ kein Ruckeln beim Aufholen nach einem Tab-Wechsel.ScrollTrigger.refresh()nach Schriftarten und Laden → Trigger-Positionen stimmen mit dem endgültigen Layout überein.
Vanilla HTML/JS
Verwende assets/vanilla-setup.js als Einstiegsmodul und importiere lenis von dort, wo benötigt.
4. React Bits — Komponenten auswählen und installieren
- Finde die Komponente in
references/react-bits-catalog.md(gruppiert: Textanimationen, Animationen, Komponenten, Mikro, Hintergründe — Name, was sie tut, Abhängigkeiten). - Wähle die auf das Projekt abgestimmte Variante:
JSoderTS, dannCSSoderTW(Tailwind). - Installiere:
Für dienpx shadcn@latest add @react-bits/SplitText-TS-TW@react-bits/-Kurzform musscomponents.jsondes Projekts enthalten:Kein{ "registries": { "@react-bits": "https://reactbits.dev/r/{name}.json" } }components.json/ kein shadcn-Projekt? Verwende stattdessen die direkte URL:npx shadcn@latest add https://reactbits.dev/r/SplitText-TS-TW.json # oder npx jsrepo@latest add https://reactbits.dev/r/SplitText-TS-TW - Öffne die installierte Datei und lies ihre Eigenschaften, bevor du sie verwendest — jede Komponente ist konfigurierbar (Farben, Geschwindigkeit, Verzögerung, Timing-Funktion, Auslöser). Setze die Eigenschaften so, dass sie zu den vorhandenen Design-Token der Website (Farben, Schriftarten) passen, anstatt die Demo-Standardwerte zu belassen.
- Wenn der Benutzer den Agenten-Workflow wünscht:
npx shadcn@latest mcp init --client claudeverbindet Claude Code über MCP mit der Registrierung.
Integrationshinweise:
- React Bits-Komponenten, die beim Scrollen animieren (ScrollReveal, ScrollFloat, AnimatedContent, SplitText…), verwenden intern GSAP ScrollTrigger oder IntersectionObserver → sie funktionieren automatisch mit Lenis, solange §3 eingerichtet ist.
- Komponenten sind Client-Komponenten (
'use client'). Rendere sie in Next.js innerhalb von Client-Komponenten oder Seiten, die dies erlauben. - WebGL/Shader-Hintergründe (Abhängigkeiten
three,ogl,vgpu) sind schwer: maximal eine oder zwei pro Seite, lazy-lade die unter dem Fold (next/dynamicmitssr: falseoderReact.lazy) und gib ihnen einen Container mit fester Größe. Pausiere sie, wenn sie nicht sichtbar sind oder der Tab versteckt ist. - Stapele nicht zwei Cursor-Effekte oder zwei Hintergründe im selben Viewport.
- Prüfe jede Komponente auf eine Pause-Steuerung, wenn sie länger als 5 Sekunden läuft (siehe
references/accessibility-motion.md§5). - Lizenz: React Bits ist MIT + Commons Clause — kostenlos nutzbar innerhalb jeder Kunden-Website (einschließlich bezahlter Kundenarbeit), aber die Komponenten selbst dürfen nicht als Paket/Vorlage weiterverkauft oder weiterverteilt werden. Füge niemals React Bits-Quellcode in diese Skill oder eine gemeinsam genutzte Bibliothek ein; installiere immer aus der Registrierung.
5. GSAP-Grundlagen (benutzerdefinierte Animation)
Immer in React über useGSAP mit einem scope — niemals rohes useEffect:
'use client';
import { useRef } from 'react';
import gsap from 'gsap';
import { ScrollTrigger } from 'gsap/ScrollTrigger';
import { useGSAP } from '@gsap/react';
gsap.registerPlugin(ScrollTrigger, useGSAP);
export default function Story() {
const root = useRef(null);
useGSAP(() => {
const tl = gsap.timeline({
scrollTrigger: { trigger: root.current, start: 'top top', end: '+=150%', scrub: 1, pin: true },
});
tl.from('.line', { yPercent: 100, autoAlpha: 0, stagger: 0.15 })
.to('.image', { scale: 1.15 }, '<');
}, { scope: root });
return <section ref={root}>…</section>;
}
Kernmuster (Details + responsives matchMedia, Batching, FOUC, Checkliste in references/gsap.md):
- Zeitlinien für alles mit >1 Element;
ScrollTrigger.batch()für wiederholte Karten. scrubfür scroll-verknüpfte Bewegung (mit Lenis istscrub: truebereits glatt;scrub: 1fügt zusätzliche Verzögerung hinzu).pin: truefunktioniert mit Lenis beim nativen Scrollen — keinepinType-Hacks nötig, wenn Lenisrootverwendet.- Horizontaler Scroll-Abschnitt: pinne den Wrapper, tweene das
xdes Tracks zu-(track.scrollWidth - innerWidth),scrub: true,invalidateOnRefresh: true. Bei RTL kehre die Richtung um (siehereferences/rtl-arabic.md§6). - Ummantle dekorative Blöcke in
gsap.matchMedia(), damit Benutzer mit reduzierter Bewegung den Ersatz erhalten (references/accessibility-motion.md§2). - Füge
visibility: hiddenzu Elementen hinzu, die im HTML sind, aber erst nach der Animation sichtbar sein sollen (FOUC vermeiden). Kein JS-FOUC-Schutz nötig, wenn der CSS-FOUC-Schutz vorhanden ist.
6. Barrierefreiheit in Bewegung
Quelle: references/accessibility-motion.md (Fallback für prefers-reduced-motion: nur ein statischer Start-/Endzustand, kein Timeline-Verhalten; ::before zuerst laden, damit der Stil schon da ist; Komponenten bieten reduceMotion als Prop oder entfernen sich selbst).
7. Qualitätssicherungsmodus — wann aktivieren
Nach der Fertigstellung führe references/quality-bar.md als Checkliste aus:
- Ist die Website frei von generischen Output-Merkmalen?
- Entspricht das Layout pixelgenau der genehmigten Gestaltung?
- Sind Schriftauswahl und Typografie konsistent?
- Funktioniert die Website auf Mobilgeräten, Tablets und Desktops?
- Sind interaktive Elemente tastatur- und screenreaderzugänglich?
- Respektiert die Bewegung die
prefers-reduced-motion-Einstellung des Benutzers? - Sind Formulare vollständig implementiert mit den fünf Zuständen (Standard, Fokus, gültig, ungültig, gesendet)?
- Sind Analysetools (falls angefordert) korrekt integriert?
- Sind die Schriftarten korrekt eingebunden? (
assets/fonts-checklist.md) - Wurden die aktuellen Limits der kostenlosen Dienste überprüft?
- Wurde der
SmoothScroll-Anbieter korrekt eingerichtet und ist aktiv? - Sind Animationen auf ihre Dauer überprüft und pausierbar, wenn sie länger als 5 Sekunden laufen?
- Gibt es Konflikte zwischen CSS-Klassen aus React Bits-Komponenten und dem Rest des Stylesheets?
- Sind beim Bau einer RTL-Website die Layout-Spiegelungen korrekt angewendet? (überprüfe
references/rtl-arabic.md)
8. Bereitstellung und Lieferung
- Führe den Build-Befehl für das Framework aus (
npm run buildfür Next.js,npm run buildfür Vite, etc.) - Überprüfe auf Build-Fehler oder Warnungen.
- Wenn das Projekt auf Vercel/Netlify gehostet wird, bestätige die erfolgreiche Bereitstellung.
- Wenn der Benutzer den Build lokal bereitstellen möchte, stelle sicher, dass die Build-Artefakte im entsprechenden Ordner (
out/,dist/,.next/) vorhanden sind. - Gib dem Benutzer eine Zusammenfassung des Builds und der Bereitstellung.
9. Fehlerbehebung bei häufigen Problemen
| Problem | Ursache | Lösung |
|---|---|---|
| Lenis/ScrollTrigger-Animationen feuern nicht | Lenis und GSAP sind nicht korrekt verdrahtet (§3) | Überprüfe, dass lenis.on('scroll', ScrollTrigger.update) und gsap.ticker.add(...) in SmoothScroll.jsx vorhanden sind |
| Animationen ruckeln nach einem Tab-Wechsel | lagSmoothing ist nicht deaktiviert | Setze gsap.ticker.lagSmoothing(0) in der Verdrahtung (§3) |
| React Bits-Komponente zeigt keine Animation | Falsche oder fehlende Eigenschaften | Öffne die Komponentendatei und lies deren Props-Dokumentation |
| Horizontales Scrollen funktioniert nicht bei RTL | Die Richtung des x-Tweens ist nicht invertiert | Siehe references/rtl-arabic.md §6 |
| Lenis und ScrollSmoother gleichzeitig aktiv | ScrollSmoother ist installiert und registriert | Entferne ScrollSmoother aus dem Projekt (§2) |
10. Zusammenfassung
- Goldene Regel: Kein Redesign. Implementiere genau, was angefragt wurde.
- Aufnahme-Fragebogen: Führe ihn bei jeder neuen Website aus, bevor du Code schreibst.
- Tool-Stack: Lenis für sanftes Scrollen, GSAP/ScrollTrigger für Animationen, React Bits für vorgefertigte Komponenten.
- Verdrahtung: Lenis + GSAP + ScrollTrigger müssen korrekt integriert sein (§3).
- Designrichtung: Wenn kein Kundendesign vorhanden ist, wähle eine Richtung aus den Referenzen.
- Qualität: Überprüfe den Build anhand der Qualitäts-Checkliste, bevor du ihn präsentierst.
- Barrierefreiheit: Respektiere
prefers-reduced-motionund sorge für Tastatur-/Screenreader-Zugänglichkeit. - Kostenlose Dienste: Überprüfe die aktuellen Limits von Drittanbieterdiensten vor der Integration.
- Lizenz: React Bits ist MIT + Commons Clause — innerhalb von Kundenprojekten frei nutzbar, aber nicht als Paket weiterverkaufbar.
11. Referenzen
references/intake-questionnaire.md— Aufnahme-Fragebogenreferences/quality-bar.md— Qualitätssicherungs-Checklistereferences/design-styles.md— Designrichtungenreferences/visual-references.md— Prompt Motion und visuelle Bibliothekreferences/react-bits-catalog.md— React Bits-Komponentenkatalogreferences/gsap.md— GSAP-Kernmuster und -Detailsreferences/rtl-arabic.md— RTL/Arabisch-spezifische Layout-Richtlinienreferences/accessibility-motion.md— Barrierefreiheit in Bewegungreferences/forms-and-states.md— Formularimplementierung und Zuständereferences/free-services.md— Liste der Drittanbieter-Kostenlosdiensteassets/SmoothScroll.jsx— Lenis + GSAP-Verdrahtungskomponente (React)assets/vanilla-setup.js— Lenis + GSAP-Verdrahtung (Vanilla JS)assets/fonts-checklist.md— Schriftarten-Implementierungs-Checkliste