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
-
Inicie um novo projeto Next.js (se ainda não tiver feito):
npx create-next-app@latest my-landing --typescript --tailwind --app -
Instale as dependências principais (conforme visto no
package.jsonda 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, configure o Lingui (consulte a documentação do Lingui).
-
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 -
Copie padrões-chave do código-fonte da CodeBridge:
- i18n: Use
@linguicom 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 viaABTestProvider. - 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-motioncomAnimatedSectionpara entradas acionadas por rolagem. - Temas: Variáveis CSS com suporte a modo escuro.
- i18n: Use
-
Construa seções como componentes client-side componíveis (usando
'use client'onde necessário). Cada seção reside emcomponents/sections/e é importada empage.tsx. -
Adicione um mascote (opcional) – veja
AnimatedMascot.tsxpara um personagem divertido e consciente de rolagem.
Componentes principais (da landing page CodeBridge)
| Componente | Propósito |
|---|---|
Hero | Título principal, botões CTA, contador de lista de espera ao vivo, demonstração de terminal |
FeatureBelt | Três funcionalidades principais com ícones e popovers de informação |
ComparisonTable | Comparação de funcionalidades vs. concorrentes |
WorktreeSection | Explica worktrees paralelos com diagrama animado |
HowItWorks | Guia de instalação em três etapas com visuais |
PricingCards / PricingTable | Exibição de preços testada com A/B |
LaunchCountdown | Temporizador de contagem regressiva + formulário de lista de espera |
TestimonialsSection | Carrossel de depoimentos de usuários |
Footer | Links, 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-intlou 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)