Communitygithub.com

elcoosp/elcoosp-skills

Erstelle produktionsreife Next.js-Landingpages mit modernen Patterns – i18n, A/B-Tests, Wartelisten-Erfassung, Analytics und ausgefeilte UI-Komponenten.

Was ist elcoosp-skills?

Dieses Skillpaket befähigt Entwickler, voll funktionsfähige, hochwertige Next.js-Landingpages für SaaS-Produkte, Open-Source-Projekte oder mobile Apps zu erstellen. Es basiert auf der Architektur und den bewährten Patterns der CodeBridge-Landingpage und bietet eine klare Roadmap für den Aufbau einer modernen, skalierbaren und mehrsprachigen Seite. Die Anleitung unterstützt Next.js App Router, TypeScript, Tailwind CSS und shadcn/ui und behandelt essenzielle Funktionen wie Internationalisierung (i18n) mit Lingui, A/B-Testing über Cookies und Middleware, UTM-Tracking (First-Touch-Attribution), die Integration eines Wartelisten-Signup-Formulars mit einer Turso/libSQL-Datenbank und Echtzeit-Zähler sowie benutzerdefinierte Analytics-Events. Es ist sowohl für den schnellen Scaffold eines neuen Projekts als auch als Lernressource für Best Practices im Next.js-Frontend-Bereich konzipiert. Der Skill ist plattformunabhängig und kann mit Claude Code, Cursor oder Codex verwendet werden; er liefert architektonische Leitlinien, keine automatische Codegenerierung. Entwickler kopieren und passen die Muster aus der umfangreichen Komponentenbibliothek und der Dateistruktur manuell an, um eine Landingpage mit Hero-Bereich, Feature-Vergleichstabelle, Preistabellen, Countdown, Testimonials, Blog, FAQ und rechtlichen Seiten zu erhalten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/elcoosp/elcoosp-skills/tree/HEAD/nextjs-landing-page

In Ihrer bevorzugten KI fragen

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

Dokumentation

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

  1. Ein neues Next.js-Projekt starten (falls nicht bereits geschehen):

    npx create-next-app@latest my-landing --typescript --tailwind --app
    
  2. Kernabhängigkeiten installieren (wie in der CodeBridge package.json zu 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-plugin
    

    Für i18n Lingui einrichten (siehe Lingui-Dokumentation).

  3. 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
    
  4. Wichtige Patterns aus der CodeBridge-Codebasis kopieren:

    • i18n: @lingui mit 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 über ABTestProvider injizieren.
    • UTM-Tracking: UTM-Parameter parsen, in Cookies speichern (First-Touch) und über UTMContext verfügbar machen.
    • Analytics: Umami (oder ähnlich) mit benutzerdefinierten Event-Tracking-Hooks (useAnalytics).
    • Warteliste: Datenbank (Turso) + API-Route + Live-Zähler.
    • Animationen: framer-motion mit AnimatedSection für scrollgesteuerte Eintritte.
    • Theming: CSS-Variablen mit Dark-Mode-Unterstützung.
  5. Abschnitte als komponierbare Client-seitige Komponenten erstellen (wo nötig mit 'use client'). Jeder Abschnitt lebt in components/sections/ und wird in page.tsx importiert.

  6. Ein Maskottchen hinzufügen (optional) – siehe AnimatedMascot.tsx für eine lustige, scrollbewusste Figur.

Wichtige Komponenten (aus der CodeBridge-Landingpage)

KomponenteZweck
HeroHauptüberschrift, CTA-Buttons, Live-Wartelistenzähler, Terminal-Demo
FeatureBeltDrei Kernfunktionen mit Symbolen und Info-Popover
ComparisonTableFunktionsvergleich vs. Mitbewerber
WorktreeSectionErklärt parallele Worktrees mit animiertem Diagramm
HowItWorksDrei-Schritte-Installationsanleitung mit Grafiken
PricingCards / PricingTableA/B-getestete Preisanzeige
LaunchCountdownCountdown-Timer + Wartelistenformular
TestimonialsSectionKarussell mit Benutzerzitaten
FooterLinks, 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.tsx einbetten (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/image verwenden, 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-intl oder 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)

Verwandte Skills