Instructions
Utilisez cette compétence pour structurer ou apprendre à construire une page d'atterrissage Next.js de haute qualité pour n'importe quel produit. Elle capture l'architecture, les motifs de composants et les meilleures pratiques de la page d'accueil CodeBridge – un exemple fonctionnel et prêt pour la production.
Quand l'utiliser
- Vous avez besoin d'une nouvelle page d'atterrissage pour un produit SaaS, un projet open-source ou une application mobile.
- Vous voulez implémenter des fonctionnalités modernes comme l'internationalisation (i18n), les tests A/B, le suivi UTM et un formulaire d'inscription à une liste d'attente.
- Vous cherchez une base de code Next.js (App Router) propre et maintenable avec Tailwind CSS et shadcn/ui.
- Vous voulez comprendre comment structurer une grande application Next.js avec des composants serveur, des composants client et une hiérarchie de fichiers bien organisée.
Comment l'utiliser
-
Démarrez un nouveau projet Next.js (si ce n'est pas déjà fait) :
npx create-next-app@latest mon-atterrissage --typescript --tailwind --app -
Installez les dépendances principales (comme dans le
package.jsonde CodeBridge) :npm install @lingui/core @lingui/react framer-motion lucide-react @icons-pack/react-simple-icons canvas-confetti npm install -D @lingui/cli @lingui/swc-pluginPour i18n, configurez Lingui (voir la documentation Lingui).
-
Structurez votre application selon le motif CodeBridge :
app/ ├── [lang]/ # Segment de langue dynamique │ ├── layout.tsx # Mise en page racine avec polices, fournisseurs │ ├── page.tsx # Page d'accueil – compose les sections │ ├── globals.css # Tailwind + variables personnalisées │ ├── ABTestLayoutClient.tsx │ ├── blog/ # Pages de blog │ ├── changelog/ │ ├── faq/ │ ├── features/ │ ├── pricing/ │ ├── privacy/ │ ├── security/ │ └── terms/ ├── components/ │ ├── sections/ # Grandes sections de page (Hero, Features, Pricing…) │ ├── shared/ # Composants réutilisables (Header, Footer, Terminal…) │ ├── ui/ # Composants shadcn/ui (button, card, …) │ └── mascot/ # Mascotte animée personnalisée ├── hooks/ # Hooks React personnalisés ├── lib/ # Utilitaires, configuration, constantes ├── contexts/ # Fournisseurs de contexte React (ex. UTMContext) └── types/ # Définitions TypeScript globales -
Copiez les motifs clés de la base de code CodeBridge :
- i18n : Utilisez
@linguiavec une route dynamique[lang]. Les composants serveur récupèrent les traductions, les composants client utilisent<Trans>. - Tests A/B : Attribuez des variantes via des cookies/middleware (
proxy.ts) et injectez-les viaABTestProvider. - Suivi UTM : Analysez les paramètres UTM, stockez-les dans des cookies (premier contact) et rendez-les disponibles via
UTMContext. - Analytics : Umami (ou similaire) avec des hooks de suivi d'événements personnalisés (
useAnalytics). - Liste d'attente : Base de données (Turso) + route API + compteur en direct.
- Animations :
framer-motionavecAnimatedSectionpour les entrées déclenchées par le défilement. - Thèmes : Variables CSS avec prise en charge du mode sombre.
- i18n : Utilisez
-
Construisez les sections en tant que composants composables côté client (en utilisant
'use client'si nécessaire). Chaque section se trouve danscomponents/sections/et est importée danspage.tsx. -
Ajoutez une mascotte (optionnel) – voir
AnimatedMascot.tsxpour un personnage amusant et réactif au défilement.
Composants clés (de la page d'accueil CodeBridge)
| Composant | Objectif |
|---|---|
Hero | Titre principal, boutons CTA, compteur de liste d'attente en direct, démo terminal |
FeatureBelt | Trois fonctionnalités principales avec icônes et popovers d'information |
ComparisonTable | Comparaison des fonctionnalités vs concurrents |
WorktreeSection | Explique les arbres de travail parallèles avec diagramme animé |
HowItWorks | Guide d'installation en trois étapes avec visuels |
PricingCards / PricingTable | Affichage des prix testé A/B |
LaunchCountdown | Compte à rebours + formulaire d'inscription liste d'attente |
TestimonialsSection | Carrousel de témoignages utilisateurs |
Footer | Liens, réseaux sociaux, copyright |
Meilleures pratiques
- Composants serveur par défaut – déplacez la logique client vers des composants feuilles ou utilisez
'use client'avec parcimonie. - Configuration centralisée –
lib/constants.ts,lib/ab-tests.ts,lib/roadmap-data.ts. - Hooks personnalisés – encapsulez la logique (ex.
useAnalytics,useChannelExperiment). - Fournisseurs de contexte – enveloppez dans
layout.tsx(ex.UTMProvider,ABTestProvider). - Variables d'environnement – utilisez
NEXT_PUBLIC_*pour les valeurs côté client. - Accessibilité – indicateurs de focus, libellés ARIA, navigation au clavier (voir
InfoPopover.tsx). - Performance – chargez paresseusement les images en dessous de la ligne de flottaison, utilisez
next/image, préchargez les polices.
Résultat
Après avoir suivi cette compétence, vous aurez :
- Un projet Next.js avec App Router, TypeScript, Tailwind CSS et shadcn/ui.
- Une page d'atterrissage entièrement localisée (anglais, français, espagnol) avec un routage dynamique.
- Une infrastructure de tests A/B avec attribution de variantes basée sur les cookies.
- Un suivi UTM avec attribution au premier contact.
- Une inscription à une liste d'attente avec base de données Turso et compteur en temps réel.
- Une interface utilisateur soignée, responsive, avec animations et une mascotte.
- Des pages blog, changelog, FAQ, tarifs et légales.
Exemples
Exemple 1 : Créer une page d'atterrissage pour un nouveau produit SaaS
Utilisateur : J'ai besoin d'une page d'atterrissage pour mon nouvel outil de gestion de projet appelé "TaskFlow".
Agent : Je vais t'aider à construire une page d'atterrissage Next.js en utilisant les motifs de CodeBridge.
D'abord, créons le projet :
npx create-next-app@latest taskflow-landing --typescript --tailwind --app
Ensuite, nous installerons les dépendances et mettrons en place la structure comme documenté dans la compétence.
Exemple 2 : Ajouter un formulaire d'inscription à une liste d'attente sur une page existante
Utilisateur : Comment ajouter un formulaire d'inscription avec un compteur en direct ?
Agent : Copiez le composant `WaitlistForm`, la route `/api/subscribe` et le schéma de base de données de la compétence. Ensuite, configurez une base de données Turso et ajoutez les variables d'environnement.
Limites
- Cette compétence fournit des conseils architecturaux, pas un générateur de code automatique. Vous devez copier et adapter manuellement les motifs.
- La configuration i18n suppose Lingui ; vous pouvez la remplacer par
next-intlou une autre bibliothèque si vous préférez. - L'implémentation des tests A/B est basée sur les cookies et peut ne pas passer à l'échelle pour des millions d'utilisateurs sans un service dédié.
Dépendances
- Next.js 14+ (App Router)
- TypeScript
- Tailwind CSS
- shadcn/ui (optionnel mais largement utilisé)
- Lingui (pour i18n)
- Framer Motion (pour les animations)
- Turso / libSQL (pour la base de données de la liste d'attente)
- Umami (ou tout fournisseur d'analytics)