Communitygithub.com

nicolas2601/router-skills

Vollständige Vorlage für eine Premium-Landingpage im Apple-/Stripe-/Sony-Bravia-Stil mit 9 typisierten Abschnitten (Liquid-Glass-Navbar, Canvas-Hero mit Scroll-Scrub, asymmetrisches Bento-Services, 4-Spalten-Warum-Wir, nummerierter Prozess, Video-Statistiken, doppelter Marquee-Testimonials, 2-Spalten-FAQ, kinematografischer CTA mit Footer). Erforderlicher Stack: Vite + React 18 + TypeScript + Tailwind v4 + shadcn/ui + Framer Motion + lucide-react + @fontsource.

Was ist router-skills?

Dieses Skill-Template generiert eine hochwertige, preskriptive Landingpage mit kinematografischen Effekten, die an das Design von Apple AirPods Pro, Stripe und Sony Bravia angelehnt ist. Es umfasst **9 genau spezifizierte Abschnitte**: eine fließende Liquid-Glass-Navbar, einen Canvas-Hero mit Scroll-Scrub-Video, ein asymmetrisches 6-Karten-Bento-Grid, eine 4-spaltige Warum-Wir-Sektion, einen nummerierten horizontalen Prozess, einen Video-Hintergrund mit Count-up-Statistiken, zwei gegenläufige Marquee-Reihen für Testimonials, ein 2-spaltiges FAQ mit Sticky-Titel und einen filmreifen CTA mit Footer. Der **erforderliche Technologie-Stack** ist strikt vorgegeben und nicht austauschbar: Vite + React 18 + TypeScript + Tailwind CSS v4 + shadcn/ui + Framer Motion + lucide-react + @fontsource. Der Skill enthält außerdem detaillierte Design-Tokens (HSL-Palette, Schriftarten, Liquid-Glass-Utilities), 5 Animations-Primitiven und 15 Anti-Slop-Guardrails, die häufige Designfehler verhindern sollen. Er ist für Agenten wie Claude Code, Cursor oder Codex optimiert, die die SKILL.md direkt lesen und die Landingpage generieren sollen. **Hauptvorteile**: Vollständige, sofort einsetzbare Vorlage, codierte Best Practices, keine unnötigen Abhängigkeiten, hohe Performance (Lighthouse ≥ 85, LCP < 2,5 s) und strikte Einhaltung des visuellen Stils.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nicolas2601/router-skills/tree/HEAD/skills/cinematic-landing-template

In Ihrer bevorzugten KI fragen

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

Dokumentation

Kinematografische Landingpage-Vorlage

Preskriptive Vorlage für eine Premium-Landingpage mit Scroll-Scrub-Canvas-Hero. Inspiriert von Apple AirPods Pro, Stripe und Sony Bravia.

Erforderlicher Stack (nicht austauschbar)

npm create vite@latest . -- --template react-ts
npm install
npm install -D tailwindcss@next @tailwindcss/vite @tailwindcss/postcss autoprefixer
npm install motion lucide-react
npm install @fontsource/{display-font} @fontsource/{body-font}
npx shadcn@latest init -d
npx shadcn@latest add button accordion

Dateistruktur

src/
  App.tsx
  main.tsx
  index.css                  # Design-Tokens + Tailwind @theme + Liquid-Glass-Utilities
  components/
    ScrubSequence.tsx        # Canvas-Frame-Renderer (KRITISCH)
    BlurText.tsx             # Wort-Stagger-Headline (KRITISCH)
    Navbar.tsx               # Schwebende Liquid-Glass-Pille
    Hero.tsx                 # Scroll-Scrub-Canvas + Headline + CTAs
    ServicesBento.tsx        # 6-Karten-asymmetrisches Bento
    Pourquoi.tsx             # 4-Spalten-Warum-Wir-Grid
    Process.tsx              # 3-4-Schritte-nummerierter horizontaler Ablauf
    Stats.tsx                # Video-Hintergrund + 4 Statistiken mit Count-up
    Testimonials.tsx         # 2 Reihen Marquee in entgegengesetzten Richtungen
    Faq.tsx                  # 2-Spalten-Layout (Sticky-Titel + Akkordeon)
    CtaFooter.tsx            # Kinematografischer Video-Hintergrund + CTA + Footer-Leiste
    ui/
      button.tsx             # Mit Varianten hero, heroGlass, heroSolid
      accordion.tsx
  lib/
    utils.ts
    constants.ts             # FRAME_COUNT, FRAMES_PATH, FRAME_EXT
public/
  frames/                    # frame_0001.jpg ... frame_NNNN.jpg

Die 9 Abschnitte – obligatorische Muster

1. Navbar (schwebende Liquid-Glass-Pille)

  • fixed top-4 left-1/2 -translate-x-1/2 z-50 mit liquid-glass rounded-full px-2 py-2
  • 3 Zonen: Logo+Marke (links) | Navigationslinks zentriert (md+) | CTA (rechts)
  • Scroll > 40px: top-4 → top-2 + backdrop-blur-xl
  • Mobil: Hamburger + Sheet im Vollbildmodus mit Liquid-Glass

2. Hero (Scroll-Scrub-Canvas)

  • <section ref={scrollRef} className="relative h-[250vh]"> (250vh gibt Scroll für Frame-Sequenz)
  • <div className="sticky top-0 h-screen overflow-hidden"> zum Fixieren
  • Canvas absolut inset-0 z-0
  • Radialer Vignetten-Verlauf z-1
  • Unterer Ausblendeverlauf z-2 zur nächsten Sektion
  • Inhalt (Badge + BlurText H1 + Untertitel + CTAs + Partner-Marquee) z-10

3. ServicesBento (asymmetrisch mit 6 Karten)

  • Grid md:grid-cols-3 gap-5
  • Karte 0: hoch row-span-2
  • Karten 1-2: klein
  • Karte 3: breit col-span-2
  • Karte 4: klein
  • Karte 5: volle Breite col-span-3
  • Jede Karte: liquid-glass rounded-2xl + Icon in liquid-glass-strong rounded-full size-11 + Display-Überschrift + Textkörper 38 Zeichen + ArrowUpRight oben rechts

4. Pourquoi (4-Spalten-Warum-Wir)

  • Grid lg:grid-cols-4 gap-5 mt-16
  • Jede Karte: liquid-glass + Icon + Display-Titel + Textkörper 30 Zeichen + Akzentlinie unten

5. Process (nummeriert horizontal)

  • md:grid-cols-4 gap-0 (gap-0, weil Verbinder die Lücke füllen)
  • Riesige Nummer text-[140px] text-primary/25 überlappend
  • Horizontaler Verbinder: absolute top-20 -right-0 h-px w-full bg-gradient-to-r from-border via-border to-transparent

6. Stats (Video-Hintergrund + Count-up)

  • Video-Hintergrund filter saturate(0) entsättigt
  • Oben + unten 200px Farbverläufe zum Ausblenden
  • Zentrale Karte liquid-glass rounded-3xl p-14
  • 4 Statistiken: Wert font-display italic text-7xl + Beschriftung uppercase tracking-wide text-sm
  • Zähler mit motion ab 0 animieren, sobald er im Viewport erscheint

7. Testimonials (2 Marquee-Reihen)

  • Reihe 1: animate-[marquee_28s_linear_infinite]
  • Reihe 2: animate-[marquee-rev_32s_linear_infinite] (entgegengesetzte Richtung)
  • Maske: [mask-image:linear-gradient(to_right,transparent,black_8%,black_92%,transparent)]
  • Pause bei Hover: hover:[animation-play-state:paused]

8. FAQ (2-Spalten-Layout)

  • Grid md:grid-cols-[0.9fr_1.1fr] gap-16
  • Links: Sticky md:sticky md:top-24 mit Badge + Display-Überschrift + Absatz + Button
  • Rechts: shadcn Accordion mit gestylten Elementen

9. CTA + Footer

  • Video-Hintergrund filter brightness(0.55) (KEIN saturate-0 hier, anders als bei Stats)
  • Überschrift font-display italic text-[180px] (KEIN uppercase hier – italic ist ein anderer Stil)
  • Footer: border-t + Copyright + Footer-Links

Design-Tokens (index.css)

@import "@fontsource/{display-font}/400.css";
@import "@fontsource/{display-font}/700.css";
@import "@fontsource/{body-font}/400.css";
@import "tailwindcss";

:root {
  /* Rohe HSL-Palette-Tripel (ohne hsl()-Wrapper für Alpha in Tailwind) */
  --ink:    20 15% 9%;
  --cream:  40 30% 90%;
  --ochre:  32 55% 65%;
  --terra:  14 55% 31%;

  /* Semantisch */
  --background: var(--ink);
  --foreground: var(--cream);
  --primary: var(--ochre);
  --secondary: var(--terra);
  --muted: 240 4% 16%;
  --muted-foreground: 40 6% 72%;
  --border: 40 30% 90% / 0.18;
  --ring: var(--ochre);
  --radius: 0.75rem;

  /* Typografie */
  --font-display: "Oswald", "Impact", sans-serif;
  --font-body: "Inter", -apple-system, sans-serif;

  /* Layout */
  --gutter: clamp(20px, 4.2vw, 56px);
  --max: 1440px;
}

@theme {
  --color-background: hsl(var(--background));
  --color-foreground: hsl(var(--foreground));
  --color-primary: hsl(var(--primary));
  /* ... restliche semantische Tokens */
  --animate-marquee: marquee 28s linear infinite;
  --animate-marquee-rev: marquee-rev 32s linear infinite;
}

@keyframes marquee { from { transform: translateX(0) } to { transform: translateX(-50%) } }
@keyframes marquee-rev { from { transform: translateX(-50%) } to { transform: translateX(0) } }

Liquid-Glass-Utilities (@layer components)

.liquid-glass {
  background: rgba(255,255,255,0.01);
  background-blend-mode: luminosity;
  backdrop-filter: blur(4px);
  border: none;
  box-shadow: inset 0 1px 1px rgba(255,255,255,0.1);
  position: relative;
  overflow: hidden;
}
.liquid-glass::before {
  content: '';
  position: absolute;
  inset: 0;
  border-radius: inherit;
  padding: 1.4px;
  background: linear-gradient(180deg,
    rgba(255,255,255,0.45) 0%, rgba(255,255,255,0.15) 20%,
    rgba(255,255,255,0)    40%, rgba(255,255,255,0)    60%,
    rgba(255,255,255,0.15) 80%, rgba(255,255,255,0.45) 100%);
  -webkit-mask: linear-gradient(#fff 0 0) content-box, linear-gradient(#fff 0 0);
  -webkit-mask-composite: xor;
          mask-composite: exclude;
  pointer-events: none;
}
.liquid-glass-strong { /* identisch, aber blur(50px) + stärkerer box-shadow */ }

Animationen – 5 Primitive (KEINE neuen erfinden)

  1. BlurText (Überschriften): Wort-Stagger 0,07s, 0,7s Dauer pro Wort, Easing [0.22, 1, 0.36, 1]
  2. Fade-up-on-view (Untertitel, CTAs): initial={{opacity:0, y:16, filter:"blur(8px)"}}, whileInView={{opacity:1, y:0, filter:"blur(0)"}}, viewport={{once:true, amount:0.3}}
  3. Scroll-Scrub-Canvas (nur Hero): Muster Apple AirPods Pro. Siehe Skill scroll-scrub-canvas.
  4. Marquee (Partner, Testimonials): 28s/32s entgegengesetzte Richtungen, ausblendende Kanten, Pause bei Hover
  5. Liquid-Glass-::before-Rand (Karten, Pillen, Buttons): NIEMALS durch regulären CSS-Border ersetzen

Anti-Slop-Guardrails (15 Regeln – vor dem Einreichen lesen)

  1. KEIN Emoji irgendwo (weder in Kopie, noch in Karten, noch in Buttons)
  2. KEINE violetten/lilanen Standardverläufe (Palette ist warm: Ocker + Terra + Creme + Tinte)
  3. KEIN shadow-2xl auf Karten (Tiefe = Hintergrundunschärfe, kein Schlagschatten)
  4. KEIN rounded-3xl auf Buttons → Buttons rounded-full, Karten rounded-2xl
  5. KEIN lorem ipsum-Platzhalter hinterlassen (sichtbares [TODO: {{PLATZHALTER}}] verwenden)
  6. KEIN text-center in Textabsätzen (außer Hero + CTA – das sind eigene Welten)
  7. Überschriften: font-display uppercase tracking-tight ODER font-display italic (niemals beides im selben Element)
  8. Jeder Abschnitt: Badge + Überschrift + Untertitel-Muster (außer Hero und Footer)
  9. Nur lucide-react-Icons (keine Heroicons, kein Material, keine benutzerdefinierten SVGs außer vom Benutzer bereitgestellt)
  10. KEIN <video> für Hero – Hero ist Canvas. <video> nur in Stats- und CTA-Hintergründen.
  11. KEIN motion.div mit transition={{ duration: > 0.9 }}
  12. KEIN console.log, kein auskommentierter Code, keine leeren Dateien, keine ungenutzten Imports
  13. Kopie in {{LANG}} – Platzhalter nicht automatisch übersetzen
  14. Responsiv: 1440 Desktop-Canvas, 375px Mobil (iPhone SE) ohne horizontalen Scroll
  15. Barrierefreiheit: focus-visible:ring-2 ring-ring offset-2 offset-background, canvas aria-hidden, sr-only-Geschwister beschreiben Video

Überprüfung vor der Auslieferung

npm run dev   # startet ohne Fehler
npm run build # 0 TS-Fehler, 0 Vite-Fehler

# Visuelle Prüfungen:
# - Hero erster Paint < 300ms (Priorität Preload frame_0001)
# - Scrub kein Ruckeln > 50ms
# - Marquee-Schleife nahtlos (Array duplizieren, Mittelpunkt unsichtbar)
# - FAQ-Akkordeon sanfte Höhenänderung
# - Navbar reduziert top-4→top-2 bei Scroll > 40px
# - 375px ohne horizontalen Überlauf

# Konsole:
# - 0 React-Warnungen
# - 0 Frame-URL-404-Fehler

# Leistung:
# - Lighthouse Performance ≥ 85
# - LCP < 2,5s (frame_0001 mit <link rel="preload"> vorladen)

Bilderfassungs-Pipeline

mkdir -p input public/frames

ffmpeg -i input/source.mp4 \
  -vf "fps=30,scale='min(1920,iw)':'-2':flags=lanczos" \
  -q:v 3 \
  public/frames/frame_%04d.jpg

ls public/frames | wc -l  # in FRAME_COUNT einfügen

WebP optional (~40 % kleiner):

for f in public/frames/*.jpg; do
  cwebp -q 82 "$f" -o "${f%.jpg}.webp" && rm "$f"
done

Wenn Gesamtgröße > 20 MB und Deployment auf Vercel Hobby (25 MB Limit): Warnung und Vorschlag für externes CDN.

Ressourcen

  • ScrubSequence-Komponente: siehe Skill scroll-scrub-canvas
  • Animationsprinzipien: Skill emilkowalski-skill
  • Premium-Komponenten: Skill magic-mcp-21st
  • Tailwind v4-Dokumentation: https://tailwindcss.com/docs/v4-beta
  • shadcn/ui: https://ui.shadcn.com
  • Framer Motion (motion.dev): Skill motion

Verwandte Skills