Communitygithub.com

elcoosp/elcoosp-skills

Crea páginas de aterrizaje Next.js listas para producción con patrones modernos: i18n, pruebas A/B, captura de lista de espera, analítica y componentes de interfaz pulidos.

¿Qué es elcoosp-skills?

Este skill está diseñado para guiar a desarrolladores en la creación de páginas de aterrizaje Next.js de alta calidad para cualquier producto, tomando como referencia la landing page de CodeBridge (codebridge.dev), un ejemplo funcional y listo para producción. Cubre la arquitectura completa, patrones de componentes y mejores prácticas, incluyendo características modernas como internacionalización (i18n) con @lingui, pruebas A/B mediante cookies/middleware, seguimiento UTM con atribución de primer contacto, captura de lista de espera con base de datos Turso, analítica con Umami y animaciones con Framer Motion. El skill es compatible con Next.js 14+ (App Router), TypeScript, Tailwind CSS y shadcn/ui, y proporciona una estructura de proyecto organizada con componentes reutilizables, hooks personalizados y proveedores de contexto. No es un generador de código automático, sino una guía arquitectónica que requiere adaptación manual de los patrones, pero permite construir rápidamente una landing page pulida, accesible y optimizada para rendimiento, con soporte para múltiples idiomas, pruebas de variantes y una experiencia de usuario completa con blog, changelog, FAQ, precios y páginas legales.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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

  1. Inicia un nuevo proyecto Next.js (si aún no lo has hecho):

    npx create-next-app@latest mi-landing --typescript --tailwind --app
    
  2. Instala las dependencias principales (como se ve en el package.json de 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-plugin
    

    Para i18n, configura Lingui (consulta la documentación de Lingui).

  3. 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
    
  4. Copia patrones clave del código de CodeBridge:

    • i18n: Usa @lingui con 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 de ABTestProvider.
    • 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-motion con AnimatedSection para entradas activadas por desplazamiento.
    • Temas: Variables CSS con soporte para modo oscuro.
  5. Construye secciones como componentes cliente componibles (usando 'use client' donde sea necesario). Cada sección vive en components/sections/ y se importa en page.tsx.

  6. Añade una mascota (opcional) – consulta AnimatedMascot.tsx para un personaje divertido y consciente del desplazamiento.

Componentes Clave (de la página de aterrizaje de CodeBridge)

ComponentePropósito
HeroTitular principal, botones CTA, contador de lista de espera en vivo, demostración de terminal
FeatureBeltTres características principales con iconos y ventanas emergentes de información
ComparisonTableComparación de características frente a competidores
WorktreeSectionExplica los worktrees paralelos con un diagrama animado
HowItWorksGuía de instalación en tres pasos con imágenes
PricingCards / PricingTableVisualización de precios con pruebas A/B
LaunchCountdownTemporizador de cuenta atrás + formulario de lista de espera
TestimonialsSectionCarrusel de citas de usuarios
FooterEnlaces, 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-intl u 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)

Skills relacionados