Communitygithub.com

elcoosp/elcoosp-skills

Crie landing pages Next.js prontas para produção com padrões modernos – i18n, testes A/B, captura de lista de espera, analytics e componentes de UI refinados.

O que é elcoosp-skills?

Esta skill fornece um guia arquitetural completo para construir landing pages Next.js de alta qualidade, inspiradas no site da CodeBridge (codebridge.dev), que é um exemplo funcional e pronto para produção. Ela cobre desde a configuração inicial do projeto com App Router, TypeScript e Tailwind CSS até a implementação de funcionalidades avançadas como internacionalização (i18n) com Lingui, testes A/B baseados em cookies, rastreamento de UTM com atribuição de primeiro toque, e um formulário de lista de espera com banco de dados Turso e contador em tempo real. Além disso, a skill orienta sobre a estruturação de componentes (seções, compartilhados, ui, mascote), hooks personalizados (useAnalytics, useChannelExperiment), provedores de contexto (UTMProvider, ABTestProvider) e boas práticas de performance, acessibilidade e organização de código. É ideal para desenvolvedores que desejam criar landing pages para produtos SaaS, projetos open-source ou aplicativos mobile, seguindo padrões modernos e mantendo um código limpo e de fácil manutenção.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Instruções

Use esta skill para estruturar ou aprender como construir uma landing page Next.js de alta qualidade para qualquer produto. Ela captura a arquitetura, padrões de componentes e melhores práticas da CodeBridge landing page – um exemplo funcional e pronto para produção.

Quando usar

  • Você precisa de uma nova landing page para um produto SaaS, projeto open-source ou aplicativo móvel.
  • Você deseja implementar funcionalidades modernas como internacionalização (i18n), testes A/B, rastreamento de UTM e um formulário de lista de espera.
  • Você está buscando uma base de código Next.js (App Router) limpa e de fácil manutenção com Tailwind CSS e shadcn/ui.
  • Você quer entender como estruturar uma aplicação Next.js grande com componentes servidor, componentes cliente e uma hierarquia de arquivos bem organizada.

Como usar

  1. Inicie um novo projeto Next.js (se ainda não tiver feito):

    npx create-next-app@latest my-landing --typescript --tailwind --app
    
  2. Instale as dependências principais (conforme visto no package.json da 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, configure o Lingui (consulte a documentação do Lingui).

  3. Estruture seu aplicativo seguindo o padrão da CodeBridge:

    app/
    ├── [lang]/                 # Segmento de idioma dinâmico
    │   ├── layout.tsx          # Layout raiz com fontes, providers
    │   ├── page.tsx            # Página inicial – compõe seções
    │   ├── globals.css         # Tailwind + variáveis customizadas
    │   ├── ABTestLayoutClient.tsx
    │   ├── blog/               # Páginas do blog
    │   ├── changelog/
    │   ├── faq/
    │   ├── features/
    │   ├── pricing/
    │   ├── privacy/
    │   ├── security/
    │   └── terms/
    ├── components/
    │   ├── sections/           # Grandes seções da página (Hero, Features, Pricing…)
    │   ├── shared/             # Componentes reutilizáveis (Header, Footer, Terminal…)
    │   ├── ui/                 # Componentes shadcn/ui (button, card, …)
    │   └── mascot/             # Mascote animado personalizado
    ├── hooks/                   # Hooks React personalizados
    ├── lib/                     # Utilitários, configuração, constantes
    ├── contexts/                # Providers de contexto React (ex.: UTMContext)
    └── types/                   # Definições globais de TypeScript
    
  4. Copie padrões-chave do código-fonte da CodeBridge:

    • i18n: Use @lingui com uma rota dinâmica [lang]. Componentes servidor buscam traduções, componentes cliente usam <Trans>.
    • Testes A/B: Atribua variantes via cookies/middleware (proxy.ts) e injete-as via ABTestProvider.
    • Rastreamento UTM: Analise parâmetros UTM, armazene em cookies (primeiro toque) e disponibilize via UTMContext.
    • Analytics: Umami (ou similar) com hooks de rastreamento de eventos personalizados (useAnalytics).
    • Lista de espera: Banco de dados (Turso) + rota de API + contador ao vivo.
    • Animações: framer-motion com AnimatedSection para entradas acionadas por rolagem.
    • Temas: Variáveis CSS com suporte a modo escuro.
  5. Construa seções como componentes client-side componíveis (usando 'use client' onde necessário). Cada seção reside em components/sections/ e é importada em page.tsx.

  6. Adicione um mascote (opcional) – veja AnimatedMascot.tsx para um personagem divertido e consciente de rolagem.

Componentes principais (da landing page CodeBridge)

ComponentePropósito
HeroTítulo principal, botões CTA, contador de lista de espera ao vivo, demonstração de terminal
FeatureBeltTrês funcionalidades principais com ícones e popovers de informação
ComparisonTableComparação de funcionalidades vs. concorrentes
WorktreeSectionExplica worktrees paralelos com diagrama animado
HowItWorksGuia de instalação em três etapas com visuais
PricingCards / PricingTableExibição de preços testada com A/B
LaunchCountdownTemporizador de contagem regressiva + formulário de lista de espera
TestimonialsSectionCarrossel de depoimentos de usuários
FooterLinks, redes sociais, direitos autorais

Melhores práticas

  • Componentes servidor por padrão – mova a lógica de cliente para componentes folha ou use 'use client' com moderação.
  • Configuração centralizada – lib/constants.ts, lib/ab-tests.ts, lib/roadmap-data.ts.
  • Hooks personalizados – encapsule lógica (ex.: useAnalytics, useChannelExperiment).
  • Providers de contexto – envolva em layout.tsx (ex.: UTMProvider, ABTestProvider).
  • Variáveis de ambiente – use NEXT_PUBLIC_* para valores do lado do cliente.
  • Acessibilidade – indicadores de foco, rótulos ARIA, navegação por teclado (veja InfoPopover.tsx).
  • Performance – carregamento preguiçoso de imagens abaixo da dobra, use next/image, pré-carregue fontes.

Resultado

Após seguir esta skill, você terá:

  • Um projeto Next.js com App Router, TypeScript, Tailwind CSS e shadcn/ui.
  • Uma landing page totalmente localizada (Inglês, Francês, Espanhol) com roteamento dinâmico.
  • Infraestrutura de testes A/B com atribuição de variante baseada em cookies.
  • Rastreamento UTM com atribuição de primeiro toque.
  • Inscrição em lista de espera com banco de dados Turso e contador em tempo real.
  • Uma UI refinada e responsiva com animações e um mascote.
  • Páginas de blog, changelog, FAQ, preços e legais.

Exemplos

Exemplo 1: Criar uma landing page para um novo produto SaaS

Usuário: Preciso de uma landing page para minha nova ferramenta de gerenciamento de projetos chamada "TaskFlow".
Agente: Vou te ajudar a construir uma landing page Next.js usando os padrões da CodeBridge.

Primeiro, vamos criar o projeto:
npx create-next-app@latest taskflow-landing --typescript --tailwind --app

Em seguida, instalaremos as dependências e configuraremos a estrutura conforme documentado na skill.

Exemplo 2: Adicionar um formulário de lista de espera a uma landing page existente

Usuário: Como adiciono um formulário de lista de espera com um contador ao vivo?
Agente: Copie o componente `WaitlistForm`, a rota `/api/subscribe` e o schema do banco de dados da skill. Em seguida, configure um banco de dados Turso e adicione as variáveis de ambiente.

Limitações

  • Esta skill fornece orientação arquitetural, não um gerador de código automático. Você deve copiar e adaptar os padrões manualmente.
  • A configuração de i18n assume Lingui; você pode substituí-lo por next-intl ou outra biblioteca, se preferir.
  • A implementação de testes A/B é baseada em cookies e pode não escalar para milhões de usuários sem um serviço dedicado.

Dependências

  • Next.js 14+ (App Router)
  • TypeScript
  • Tailwind CSS
  • shadcn/ui (opcional, mas amplamente usado)
  • Lingui (para i18n)
  • Framer Motion (para animações)
  • Turso / libSQL (para banco de dados da lista de espera)
  • Umami (ou qualquer provedor de analytics)

Habilidades Relacionadas