Instrucciones
Usa este skill para crear o aprender cómo construir una página de aterrizaje Next.js de alta calidad para cualquier producto. Captura la arquitectura, patrones de componentes y mejores prácticas de la página de aterrizaje de CodeBridge – un ejemplo funcional y listo para producción.
Cuándo Usarlo
- Necesitas una nueva página de aterrizaje para un producto SaaS, proyecto de código abierto o aplicación móvil.
- Quieres implementar características modernas como internacionalización (i18n), pruebas A/B, seguimiento UTM y un formulario de registro en lista de espera.
- Buscas una base de código Next.js (App Router) limpia y mantenible con Tailwind CSS y shadcn/ui.
- Deseas entender cómo estructurar una aplicación Next.js grande con componentes servidor, componentes cliente y una jerarquía de archivos bien organizada.
Cómo Usarlo
-
Inicia un nuevo proyecto Next.js (si aún no lo has hecho):
npx create-next-app@latest mi-landing --typescript --tailwind --app -
Instala las dependencias principales (como se ve en el
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-pluginPara i18n, configura Lingui (consulta la documentación de Lingui).
-
Estructura tu aplicación siguiendo el patrón de CodeBridge:
app/ ├── [lang]/ # Segmento de idioma dinámico │ ├── layout.tsx # Layout raíz con fuentes, proveedores │ ├── page.tsx # Página principal – compone secciones │ ├── globals.css # Tailwind + variables personalizadas │ ├── ABTestLayoutClient.tsx │ ├── blog/ # Páginas de blog │ ├── changelog/ │ ├── faq/ │ ├── features/ │ ├── pricing/ │ ├── privacy/ │ ├── security/ │ └── terms/ ├── components/ │ ├── sections/ # Grandes secciones de página (Hero, Features, Pricing…) │ ├── shared/ # Componentes reutilizables (Header, Footer, Terminal…) │ ├── ui/ # Componentes shadcn/ui (button, card, …) │ └── mascot/ # Mascota animada personalizada ├── hooks/ # Hooks personalizados de React ├── lib/ # Utilidades, configuración, constantes ├── contexts/ # Proveedores de contexto React (ej., UTMContext) └── types/ # Definiciones globales de TypeScript -
Copia patrones clave del código de CodeBridge:
- i18n: Usa
@linguicon una ruta dinámica[lang]. Los componentes servidor obtienen traducciones, los componentes cliente usan<Trans>. - Pruebas A/B: Asigna variantes mediante cookies/middleware (
proxy.ts) e inyéctalas a través deABTestProvider. - Seguimiento UTM: Parsea los parámetros UTM, almacénalos en cookies (primer contacto) y hazlos disponibles mediante
UTMContext. - Analítica: Umami (o similar) con hooks de seguimiento de eventos personalizados (
useAnalytics). - Lista de espera: Base de datos (Turso) + ruta API + contador en vivo.
- Animaciones:
framer-motionconAnimatedSectionpara entradas activadas por desplazamiento. - Temas: Variables CSS con soporte para modo oscuro.
- i18n: Usa
-
Construye secciones como componentes cliente componibles (usando
'use client'donde sea necesario). Cada sección vive encomponents/sections/y se importa enpage.tsx. -
Añade una mascota (opcional) – consulta
AnimatedMascot.tsxpara un personaje divertido y consciente del desplazamiento.
Componentes Clave (de la página de aterrizaje de CodeBridge)
| Componente | Propósito |
|---|---|
Hero | Titular principal, botones CTA, contador de lista de espera en vivo, demostración de terminal |
FeatureBelt | Tres características principales con iconos y ventanas emergentes de información |
ComparisonTable | Comparación de características frente a competidores |
WorktreeSection | Explica los worktrees paralelos con un diagrama animado |
HowItWorks | Guía de instalación en tres pasos con imágenes |
PricingCards / PricingTable | Visualización de precios con pruebas A/B |
LaunchCountdown | Temporizador de cuenta atrás + formulario de lista de espera |
TestimonialsSection | Carrusel de citas de usuarios |
Footer | Enlaces, redes sociales, derechos de autor |
Mejores Prácticas
- Componentes servidor por defecto – mueve la lógica del cliente a componentes hoja o usa
'use client'con moderación. - Configuración centralizada –
lib/constants.ts,lib/ab-tests.ts,lib/roadmap-data.ts. - Hooks personalizados – encapsula lógica (ej.,
useAnalytics,useChannelExperiment). - Proveedores de contexto – envuélvelos en
layout.tsx(ej.,UTMProvider,ABTestProvider). - Variables de entorno – usa
NEXT_PUBLIC_*para valores del lado del cliente. - Accesibilidad – indicadores de foco, etiquetas ARIA, navegación por teclado (consulta
InfoPopover.tsx). - Rendimiento – carga diferida de imágenes fuera de la vista, usa
next/image, precarga fuentes.
Resultado
Después de seguir este skill, tendrás:
- Un proyecto Next.js con App Router, TypeScript, Tailwind CSS y shadcn/ui.
- Una página de aterrizaje completamente localizada (inglés, francés, español) con enrutamiento dinámico.
- Infraestructura de pruebas A/B con asignación de variantes basada en cookies.
- Seguimiento UTM con atribución de primer contacto.
- Registro en lista de espera con base de datos Turso y contador en tiempo real.
- Una interfaz pulida y responsiva con animaciones y una mascota.
- Páginas de blog, changelog, FAQ, precios y legales.
Ejemplos
Ejemplo 1: Crear una página de aterrizaje para un nuevo producto SaaS
Usuario: Necesito una página de aterrizaje para mi nueva herramienta de gestión de proyectos llamada "TaskFlow".
Agente: Te ayudaré a construir una página de aterrizaje Next.js usando los patrones de CodeBridge.
Primero, creemos el proyecto:
npx create-next-app@latest taskflow-landing --typescript --tailwind --app
Luego instalaremos las dependencias y configuraremos la estructura según lo documentado en el skill.
Ejemplo 2: Añadir un formulario de lista de espera a una página de aterrizaje existente
Usuario: ¿Cómo añado un formulario de lista de espera con un contador en vivo?
Agente: Copia el componente `WaitlistForm`, la ruta `/api/subscribe` y el esquema de base de datos del skill. Luego configura una base de datos Turso y añade las variables de entorno.
Limitaciones
- Este skill proporciona orientación arquitectónica, no un generador de código automático. Debes copiar y adaptar los patrones manualmente.
- La configuración de i18n asume Lingui; puedes reemplazarlo con
next-intlu otra biblioteca si lo prefieres. - La implementación de pruebas A/B se basa en cookies y puede no escalar a millones de usuarios sin un servicio dedicado.
Dependencias
- Next.js 14+ (App Router)
- TypeScript
- Tailwind CSS
- shadcn/ui (opcional pero muy usado)
- Lingui (para i18n)
- Framer Motion (para animaciones)
- Turso / libSQL (para la base de datos de lista de espera)
- Umami (o cualquier proveedor de analítica)