Anweisungen
Verwende diesen Skill, um eine hochwertige Next.js-Landingpage für jedes Produkt zu entwerfen oder zu lernen, wie man sie erstellt. Er fasst die Architektur, Komponenten-Patterns und Best Practices der CodeBridge-Landingpage zusammen – ein voll funktionsfähiges, produktionsreifes Beispiel.
Wann du ihn verwenden solltest
- Du benötigst eine neue Landingpage für ein SaaS-Produkt, ein Open-Source-Projekt oder eine mobile App.
- Du möchtest moderne Funktionen wie Internationalisierung (i18n), A/B-Testing, UTM-Tracking und ein Wartelisten-Anmeldeformular implementieren.
- Du suchst eine saubere, wartbare Next.js-Codebasis (App Router) mit Tailwind CSS und shadcn/ui.
- Du möchtest verstehen, wie man eine große Next.js-Anwendung mit Server-Komponenten, Client-Komponenten und einer gut organisierten Dateihierarchie strukturiert.
So verwendest du ihn
-
Ein neues Next.js-Projekt starten (falls nicht bereits geschehen):
npx create-next-app@latest my-landing --typescript --tailwind --app -
Kernabhängigkeiten installieren (wie in der CodeBridge
package.jsonzu sehen):npm install @lingui/core @lingui/react framer-motion lucide-react @icons-pack/react-simple-icons canvas-confetti npm install -D @lingui/cli @lingui/swc-pluginFür i18n Lingui einrichten (siehe Lingui-Dokumentation).
-
Deine App nach dem CodeBridge-Pattern strukturieren:
app/ ├── [lang]/ # Dynamisches Sprachsegment │ ├── layout.tsx # Root-Layout mit Schriftarten, Providern │ ├── page.tsx # Startseite – setzt Abschnitte zusammen │ ├── globals.css # Tailwind + benutzerdefinierte Variablen │ ├── ABTestLayoutClient.tsx │ ├── blog/ # Blog-Seiten │ ├── changelog/ │ ├── faq/ │ ├── features/ │ ├── pricing/ │ ├── privacy/ │ ├── security/ │ └── terms/ ├── components/ │ ├── sections/ # Große Seitenabschnitte (Hero, Features, Pricing…) │ ├── shared/ # Wiederverwendbare Komponenten (Header, Footer, Terminal…) │ ├── ui/ # shadcn/ui-Komponenten (button, card, …) │ └── mascot/ # Benutzerdefiniertes animiertes Maskottchen ├── hooks/ # Benutzerdefinierte React-Hooks ├── lib/ # Hilfsfunktionen, Konfiguration, Konstanten ├── contexts/ # React Context Provider (z. B. UTMContext) └── types/ # Globale TypeScript-Definitionen -
Wichtige Patterns aus der CodeBridge-Codebasis kopieren:
- i18n:
@linguimit einer dynamischen[lang]-Route verwenden. Server-Komponenten rufen Übersetzungen ab, Client-Komponenten verwenden<Trans>. - A/B-Testing: Varianten über Cookies/Middleware (
proxy.ts) zuweisen und überABTestProviderinjizieren. - UTM-Tracking: UTM-Parameter parsen, in Cookies speichern (First-Touch) und über
UTMContextverfügbar machen. - Analytics: Umami (oder ähnlich) mit benutzerdefinierten Event-Tracking-Hooks (
useAnalytics). - Warteliste: Datenbank (Turso) + API-Route + Live-Zähler.
- Animationen:
framer-motionmitAnimatedSectionfür scrollgesteuerte Eintritte. - Theming: CSS-Variablen mit Dark-Mode-Unterstützung.
- i18n:
-
Abschnitte als komponierbare Client-seitige Komponenten erstellen (wo nötig mit
'use client'). Jeder Abschnitt lebt incomponents/sections/und wird inpage.tsximportiert. -
Ein Maskottchen hinzufügen (optional) – siehe
AnimatedMascot.tsxfür eine lustige, scrollbewusste Figur.
Wichtige Komponenten (aus der CodeBridge-Landingpage)
| Komponente | Zweck |
|---|---|
Hero | Hauptüberschrift, CTA-Buttons, Live-Wartelistenzähler, Terminal-Demo |
FeatureBelt | Drei Kernfunktionen mit Symbolen und Info-Popover |
ComparisonTable | Funktionsvergleich vs. Mitbewerber |
WorktreeSection | Erklärt parallele Worktrees mit animiertem Diagramm |
HowItWorks | Drei-Schritte-Installationsanleitung mit Grafiken |
PricingCards / PricingTable | A/B-getestete Preisanzeige |
LaunchCountdown | Countdown-Timer + Wartelistenformular |
TestimonialsSection | Karussell mit Benutzerzitaten |
Footer | Links, Social Media, Copyright |
Best Practices
- Standardmäßig Server-Komponenten – Client-Logik in Blattkomponenten verschieben oder
'use client'sparsam einsetzen. - Zentrale Konfiguration –
lib/constants.ts,lib/ab-tests.ts,lib/roadmap-data.ts. - Benutzerdefinierte Hooks – Logik kapseln (z. B.
useAnalytics,useChannelExperiment). - Context Provider – in
layout.tsxeinbetten (z. B.UTMProvider,ABTestProvider). - Umgebungsvariablen –
NEXT_PUBLIC_*für clientseitige Werte verwenden. - Barrierefreiheit – Fokus-Indikatoren, ARIA-Labels, Tastaturnavigation (siehe
InfoPopover.tsx). - Leistung – Bilder unterhalb der Falz lazy laden,
next/imageverwenden, Schriftarten vorladen.
Ergebnis
Nach Befolgen dieses Skills hast du:
- Ein Next.js-Projekt mit App Router, TypeScript, Tailwind CSS und shadcn/ui.
- Eine vollständig lokalisierte Landingpage (Englisch, Französisch, Spanisch) mit dynamischem Routing.
- A/B-Testing-Infrastruktur mit Cookie-basierter Variantenzuweisung.
- UTM-Tracking mit First-Touch-Attribution.
- Wartelisten-Anmeldung mit Turso-Datenbank und Echtzeit-Zähler.
- Eine polierte, responsive Benutzeroberfläche mit Animationen und einem Maskottchen.
- Blog-, Changelog-, FAQ-, Preis- und rechtliche Seiten.
Beispiele
Beispiel 1: Eine Landingpage für ein neues SaaS-Produkt erstellen
Benutzer: Ich brauche eine Landingpage für mein neues Projektmanagement-Tool namens "TaskFlow".
Agent: Ich helfe dir, eine Next.js-Landingpage mit den Patterns aus CodeBridge zu erstellen.
Als Erstes erstellen wir das Projekt:
npx create-next-app@latest taskflow-landing --typescript --tailwind --app
Dann installieren wir die Abhängigkeiten und richten die Struktur ein, wie im Skill dokumentiert.
Beispiel 2: Ein Wartelistenformular zu einer bestehenden Landingpage hinzufügen
Benutzer: Wie füge ich ein Wartelistenformular mit einem Live-Zähler hinzu?
Agent: Kopiere die `WaitlistForm`-Komponente, die `/api/subscribe`-Route und das Datenbankschema aus dem Skill. Richte dann eine Turso-Datenbank ein und füge die Umgebungsvariablen hinzu.
Einschränkungen
- Dieser Skill bietet architektonische Leitlinien, keinen automatischen Code-Generator. Du musst die Patterns manuell kopieren und anpassen.
- Die i18n-Einrichtung setzt Lingui voraus; du kannst sie durch
next-intloder eine andere Bibliothek ersetzen, falls bevorzugt. - Die A/B-Testing-Implementierung basiert auf Cookies und skaliert möglicherweise nicht auf Millionen von Benutzern ohne einen dedizierten Dienst.
Abhängigkeiten
- Next.js 14+ (App Router)
- TypeScript
- Tailwind CSS
- shadcn/ui (optional, aber stark genutzt)
- Lingui (für i18n)
- Framer Motion (für Animationen)
- Turso / libSQL (für die Wartelisten-Datenbank)
- Umami (oder ein beliebiger Analytics-Anbieter)