Produkt-Landingpage
Ein Rezept, destilliert aus der Kesami-Marketing-Seite, für eine einzelne statische Seite, die designed und nicht vorlagenhaft aussieht und einer genauen Prüfung standhält: kontrastgeprüft, tastaturfreundlich, ehrlich über das Produkt, schnell.
Das Ergebnis ist eine Next.js-Seite aus serverseitig gerenderten Abschnitten. Interaktivität ist auf wenige kleine Client-„Inseln“ beschränkt, die DOM-Attribute oder CSS-Variablen umschalten, anstatt neu zu rendern. Es gibt keine UI-Bibliothek, kein Tailwind, keine Animationsbibliothek.
Was enthalten ist
| Pfad | Verwendung |
|---|---|
assets/scaffold/ | Ein vollständiges, baubares Gerüst (typgeprüft und mit next build verifiziert). Kopieren, nicht neu tippen. Platzhalter-Inhalte, funktionierendes Designsystem. |
assets/optional-sections/ | Drei zusätzliche Abschnitte aus der Original-Seite (ein Vorher/Nachher-Vergleich, eine Datenbegrenzungs-Dateibaum, eine Skript-Wand) als Arbeitsbeispiele. Nicht eingebunden. |
scripts/accent.mjs | Leitet die kontrastsicheren Akzent-Abstufungen für jede Markenfarbe ab. |
scripts/capture.cjs | Erstellt Screenshots der laufenden Seite in Desktop- und Handy-Breite, durchläuft dabei das Scrollen, über ein unsichtbares Electron-Fenster. |
references/design-system.md | Tokens, Themes, Schriftarten, Abstände, die Akzent-Kontrast-Logik und warum jedes existiert. Vor Änderungen an Farben oder Schrift lesen. |
references/section-patterns.md | Jeder Abschnitt: wofür er ist, wie er gebaut ist, der Trick, der ihn billig macht. Vor dem Hinzufügen oder Umformen eines Abschnitts lesen. |
references/motion-and-a11y.md | Bewegungsbudget, reduzierte Bewegung, kein JS, Berührungsziele, Hydrierungsfallen. Vor dem Hinzufügen von Animationen oder Client-Code lesen. |
references/copy-and-facts.md | Stimme, die Ein-Szenario-Regel und wie Behauptungen wahr bleiben. Vor dem Schreiben von Text lesen. |
references/verify.md | Die Checkliste und die auszuführenden Befehle, bevor die Seite als fertig bezeichnet wird. |
Arbeitsablauf
1. Eingaben sammeln (erst schauen, dann fragen)
Lies zuerst die README des Produkts, das Paketmanifest, die Preis-/Plan-Codes und den Release-Workflow; die meisten Antworten sind dort. Frage den Benutzer nur nach dem, was nicht zu finden ist. Du brauchst:
- Produktname, Ein-Satz-Versprechen, für wen es ist, und das eine, was es auszeichnet.
- Plattformen, Preise und Planlimits, jeweils mit der Datei, die die Quelle der Wahrheit ist.
- Eine Markenfarbe (irgendein Hex-Wert) oder die Erlaubnis, eine auszuwählen. Wähle eine einzige Farbe und verwende sie als einzige Signalfarbe.
- Ob eine lizenzierte Auszeichnungsschriftart existiert. Falls nicht, ist der Open-Lizenz-Ersatz des Gerüsts (Instrument Serif) in Ordnung.
- Welche Abschnitte zutreffen. Standardset: Hero, Ticker, Wie es funktioniert, Frage/Demo, Preise, FAQ, Abschluss, Footer. Füge Datenschutz, Sprachen oder einen Vorher/Nachher-Vergleich hinzu, wenn das Produkt eine Geschichte hat, die eine solche erfordert.
- Wo die Seite lebt. Standard: einem
website/Ordner im Produkt-Repository, ein eigenständiges Paket außerhalb von npm-Workspaces, damit die Installationen und die Lockfile der App unberührt bleiben.
2. Gerüst erstellen
cp -R ~/.claude/skills/product-landing-site/assets/scaffold <target>/website
cd <target>/website && npm install && npx tsc --noEmit && npx next build
Führe den Build einmal vor dem Bearbeiten aus, damit du weißt, dass der Ausgangszustand grün ist. Mona Sans wird zur Build-Zeit von Google Fonts abgerufen und dann von der Seite selbst ausgeliefert, daher benötigt der erste Build Netzwerkzugriff.
3. Marke anpassen
node ~/.claude/skills/product-landing-site/scripts/accent.mjs <marken-hex>gibt--accent,--accent-display, die abgeflachte Tönung und aus, ob die Beschriftung des Buttons schwarz oder weiß sein soll. Füge diese inapp/globals.cssein (--brand,--brand-hover,--brand-tint,--accent,--accent-display) und ersetze die hartcodierten#ff5e00/#e25300inapp/icon.svgundapp/opengraph-image.tsx.- Zeichne das Markenzeichen in
components/Logo.tsxundLogo.module.cssneu (der Platzhalter sind vier Sprachbalken). Halte es als Divs oder Inline-SVG, niemals als Rastergrafik. - Setze
SITEinlib/site.ts(Name, Slug, Wortmarke, Überschrift, Einleitung, CTA, Notiz). DerSlugdefiniert auch den Namensraum für die Währungspräferenz im localStorage.
Warum das Skript statt nach Augenmaß: Eine gesättigte Markenfarbe erreicht fast nie 4,5:1 als Text auf einer hellen Seite, daher benötigt die Seite die Markenfarbe für Füllungen und einen dunkleren Geschwisterton für Text. Das Erraten des Geschwistertons führt zu Seiten mit fehlendem Kontrast.
4. Fakten vor dem Text
Fülle lib/site.ts (Pläne, Plattform, Links, FAQ) aus den eigenen Quelldateien des Produkts und halte die Quelle jeder Tatsache in der README.md der Seite unter „Woher die Fakten kommen“ fest. Bewahre die Herkunft in der README und nicht in Code-Kommentaren auf, damit das Gerüst kommentarfrei bleibt. Falls das Ziel-Repository oder der Benutzer erklärende Kommentare wünscht, folge stattdessen deren Vorgaben.
Lies dann references/copy-and-facts.md und schreibe den Text.
5. Ein Szenario, überall geteilt
lib/demo.ts enthält ein einziges fiktives Szenario, aus dem der Hero-Mock, die Produktgeschichte und die interaktive Demo alle schöpfen. Ersetze es durch ein Szenario aus der eigenen Domäne des Produkts (Support-Tickets, ein Pull-Request, ein Kalender, eine Tabelle, ein Meeting). Da jeder Abschnitt dieselben Daten liest, widerspricht sich die Seite nie, und die Demo kann ehrlich den tatsächlichen Vertrag des Produkts zeigen (z. B. zitiert jede Behauptung ihre Quelle).
6. Abschnitte
Beginne mit den neun Abschnitten des Gerüsts. Entscheide für jeden Abschnitt: Welche einzelne Idee vermittelt er, und was ist die eine visuelle Darstellung, die sie beweist, anstatt sie zu beschreiben? Lese references/section-patterns.md. Halte dich an die Abschnitts-Grammatik:
- Label-Chip (
.label, mitdata-scramble), dann einh2.display.h2mit den letzten Wörtern in.em, dann eine optionale.lead - Abschnitte wechseln zwischen
data-theme="light"/"paper", so dass jeder auf einer Farbkante beginnt, nicht auf einer Linie - Ein ausgefüllter Button pro Viewport; alles andere ist ein Textlink mit der Marken-Unterstreichung
- Produkt-Mocks verwenden
data-theme="dark"und Pixel-Größen, da sie als Platzhalter für Screenshots der (dunklen) App dienen. Wenn die App hell ist, mache die Mocks hell.
7. Verifizieren
Folge references/verify.md. Kurz gesagt: Typ-Prüfung, Build, Screenshots bei 1440 und 390 mit scripts/capture.cjs, sie ansehen, durch das Scrollen gehen, um zu bestätigen, dass Enthüllungen feuern, reduzierter Bewegungsmodus und kein JS prüfen, accent.mjs --check für jede neue Textfarbe erneut ausführen. Melde alles, was nicht verifiziert wurde, anstatt zu implizieren, dass es verifiziert wurde.
Unverhandelbar, und warum
- Server-Komponenten standardmäßig; Client-Inseln nur für Verhalten. Die Seite ist statisches HTML, das ohne JS funktioniert und fast nichts kostet zu hydrieren. Inseln schreiben
data-*-Attribute oder CSS-Variablen und lassen CSS die visuelle Arbeit erledigen. - Nur semantische Tokens in Komponenten. Komponenten lesen
--bg,--fg,--accent; eindata-themeeines Abschnitts tauscht sie aus. So kann eine Komponente auf Hintergrund, Weiß, der Tönung oder einem dunklen Mock ohne Bearbeitungen sitzen. - Textgrößen in rem, Mocks in px. Die Browserschriftgröße der Leser muss auf die Seite angewendet werden; Mocks sind Platzhalter für Screenshots.
- Abgedunkelter Text zurückweichen durch Farbe, nie durch Deckkraft. Deckkraft senkt leise den Kontrast unter 4,5:1.
- Text überholt nie das Produkt. Keine unveröffentlichten Plattformen, keine Support-Adresse, die nicht existiert, kein „nichts verlässt dein Gerät“, wenn Audio zu einem Server streamt. Eine Marketing-Seite, die zu viel verspricht, ist ein Fehler.
- Keine Animation-Pause-Steuerung ist eingebaut. Sich wiederholende Bewegung stoppt für
prefers-reduced-motion. Die Kesami-Design-Review hat bewusst auf eine Pause-Steuerung verzichtet, daher hat das Gerüst keine; biete eine an, wenn der Benutzer sie wünscht.
Über das Gerüst hinaus erweitern
Erfinde neue Abschnitte mit denselben Primitiven, anstatt eine Bibliothek zu importieren: CSS Custom Properties für den Zustand, ein IntersectionObserver pro Verhalten, details/summary für Offenlegung, position: sticky für Scrollytelling, @property für das Animieren von Variablen. Wenn du dabei ertappst, nach framer-motion oder einem Karussell-Paket zu greifen, lies zuerst references/motion-and-a11y.md; die Antwort ist fast immer eine CSS-Variable und ein Attribut.