Communitygithub.com

ASoudy/AGS - Práticas Recomendadas do Next.js

Princípios do Next.js App Router: Componentes de Servidor, busca de dados e padrões de roteamento.

O que é AGS - Práticas Recomendadas do Next.js?

Esta skill fornece um guia abrangente de melhores práticas para desenvolvimento com o Next.js App Router, abordando desde a arquitetura de componentes até estratégias de caching e otimização de desempenho. Ela explica claramente quando usar Server Components (padrão) versus Client Components ('use client'), com uma árvore de decisão prática e exemplos de casos de uso. A skill também detalha padrões de busca de dados (fetch estático, ISR com revalidação, e dinâmico com 'no-store'), convenções de arquivos de roteamento (page.tsx, layout.tsx, loading.tsx, error.tsx, not-found.tsx), e como organizar rotas com grupos, paralelas e interceptação. Além disso, cobre boas práticas para rotas de API, otimização de imagens com next/image, divisão de código com importações dinâmicas, metadados estáticos e dinâmicos, e uma estratégia de caching em camadas (requisição, dados e rota completa). Inclui seções sobre Server Actions para mutações de dados, uma tabela de anti-padrões (como evitar 'use client' em todo lugar), e uma estrutura de projeto recomendada. A skill é destinada a desenvolvedores que usam Next.js 13+ e o App Router, sendo aplicável diretamente no planejamento e implementação de projetos, mas não substitui a validação específica do ambiente ou revisão de especialistas.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/AGAS/plugins/antigravity-awesome-skills-claude/skills/nextjs-best-practices

Perguntar na sua IA favorita

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

Documentação

Práticas Recomendadas do Next.js

Princípios para desenvolvimento com Next.js App Router.


1. Componentes de Servidor vs Cliente

Árvore de Decisão

Precisa de...?
│
├── useState, useEffect, event handlers
│   └── Componente Cliente ('use client')
│
├── Busca de dados direta, sem interatividade
│   └── Componente Servidor (padrão)
│
└── Ambos? 
    └── Dividir: Pai Servidor + Filho Cliente

Por Padrão

TipoUso
ServidorBusca de dados, layout, conteúdo estático
ClienteFormulários, botões, UI interativa

2. Padrões de Busca de Dados

Estratégia de Fetch

PadrãoUso
PadrãoEstático (cacheado na build)
RevalidateISR (atualização baseada em tempo)
No-storeDinâmico (a cada requisição)

Fluxo de Dados

FontePadrão
Banco de DadosFetch no Componente Servidor
APIfetch com caching
Input do usuárioState do cliente + server action

3. Princípios de Roteamento

Convenções de Arquivos

ArquivoPropósito
page.tsxUI da rota
layout.tsxLayout compartilhado
loading.tsxEstado de carregamento
error.tsxBoundary de erro
not-found.tsxPágina 404

Organização de Rotas

PadrãoUso
Grupos de rota (nome)Organizar sem afetar a URL
Rotas paralelas @slotMúltiplas páginas no mesmo nível
Interceptação (.)Overlays modais

4. Rotas de API

Manipuladores de Rota

MétodoUso
GETLer dados
POSTCriar dados
PUT/PATCHAtualizar dados
DELETERemover dados

Melhores Práticas

  • Validar input com Zod
  • Retornar códigos de status corretos
  • Tratar erros graciosamente
  • Usar Edge runtime quando possível

5. Princípios de Performance

Otimização de Imagens

  • Usar componente next/image
  • Definir prioridade para conteúdo acima da dobra
  • Fornecer placeholder de blur
  • Usar tamanhos responsivos

Otimização de Bundle

  • Importações dinâmicas para componentes pesados
  • Divisão de código baseada em rota (automática)
  • Analisar com bundle analyzer

6. Metadados

Estático vs Dinâmico

TipoUso
Export estáticoMetadados fixos
generateMetadataDinâmico por rota

Tags Essenciais

  • title (50-60 caracteres)
  • description (150-160 caracteres)
  • Imagens Open Graph
  • URL canônica

7. Estratégia de Caching

Camadas de Cache

CamadaControle
Requisiçãoopções do fetch
Dadosrevalidate/tags
Rota completaconfiguração da rota

Revalidação

MétodoUso
Baseada em temporevalidate: 60
Sob demandarevalidatePath/Tag
Sem cacheno-store

8. Server Actions

Casos de Uso

  • Submissões de formulários
  • Mutações de dados
  • Gatilhos de revalidação

Melhores Práticas

  • Marcar com 'use server'
  • Validar todos os inputs
  • Retornar respostas tipadas
  • Tratar erros

9. Anti-Padrões

❌ Não Faça✅ Faça
'use client' em todo lugarServidor por padrão
Fetch em componentes clienteFetch no servidor
Pular estados de carregamentoUse loading.tsx
Ignorar boundaries de erroUse error.tsx
Grandes bundles clienteImportações dinâmicas

10. Estrutura do Projeto

app/
├── (marketing)/     # Grupo de rota
│   └── page.tsx
├── (dashboard)/
│   ├── layout.tsx   # Layout do dashboard
│   └── page.tsx
├── api/
│   └── [resource]/
│       └── route.ts
└── components/
    └── ui/

Lembre-se: Componentes Servidor são o padrão por um motivo. Comece por lá, adicione cliente apenas quando necessário.

Quando Usar

Esta habilidade é aplicável para executar o fluxo de trabalho ou ações descritas na visão geral.

Limitações

  • Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
  • Não trate a saída como substituto para validação específica do ambiente, testes ou revisão de especialistas.
  • Pare e peça esclarecimentos se as entradas necessárias, permissões, limites de segurança ou critérios de sucesso estiverem ausentes.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ASoudy/AGS

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

One sentence - what this skill does and when to invoke it

ASoudy/AGS

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

ASoudy/AGS

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

ASoudy/AGS

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

ASoudy/AGS

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

ASoudy/AGS

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

ASoudy/AGS

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

ASoudy/AGS

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

ASoudy/AGS

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Habilidades Relacionadas