Communitygithub.com

ASoudy/AGS

Principios del App Router de Next.js. Componentes de Servidor, obtención de datos, patrones de enrutamiento.

¿Qué es AGS?

Este skill proporciona una guía completa de buenas prácticas para el desarrollo con el App Router de Next.js. Está diseñado para ayudar a desarrolladores a entender cuándo y cómo usar Server Components frente a Client Components, optimizar la obtención de datos con estrategias de caché (static, revalidation, no-store), y estructurar correctamente las rutas usando convenciones de archivos como `page.tsx`, `layout.tsx` y `loading.tsx`. Cubre principios esenciales de rendimiento (optimización de imágenes y bundles), manejo de metadatos (estáticos y dinámicos), y mejores prácticas para Server Actions y API Routes. También detalla anti-patrones comunes y ofrece una estructura de proyecto recomendada para mantener el código limpio y escalable. El skill es aplicable directamente en cualquier flujo de trabajo que requiera configurar, mantener o auditar aplicaciones basadas en Next.js 13+ con App Router, y su uso es apropiado siempre que el problema esté dentro del alcance descrito.

Compatible con~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

Preguntar en tu IA favorita

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

Documentación

Buenas Prácticas de Next.js

Principios para el desarrollo con el App Router de Next.js.


1. Componentes de Servidor vs Cliente

Árbol de Decisión

¿Necesita...?
│
├── useState, useEffect, manejadores de eventos
│   └── Componente Cliente ('use client')
│
├── Obtención directa de datos, sin interactividad
│   └── Componente Servidor (por defecto)
│
└── ¿Ambos?
    └── Dividir: Servidor padre + Cliente hijo

Por Defecto

TipoUso
ServidorObtención de datos, layout, contenido estático
ClienteFormularios, botones, UI interactiva

2. Patrones de Obtención de Datos

Estrategia de Fetch

PatrónUso
Por defectoEstático (almacenado en caché en build)
RevalidarISR (actualización basada en tiempo)
Sin almacenarDinámico (cada solicitud)

Flujo de Datos

FuentePatrón
Base de datosFetch en Componente Servidor
APIfetch con caché
Entrada del usuarioEstado del cliente + acción del servidor

3. Principios de Enrutamiento

Convenciones de Archivos

ArchivoPropósito
page.tsxUI de la ruta
layout.tsxLayout compartido
loading.tsxEstado de carga
error.tsxLímite de error
not-found.tsxPágina 404

Organización de Rutas

PatrónUso
Grupos de rutas (nombre)Organizar sin cambiar la URL
Rutas paralelas @slotMúltiples páginas al mismo nivel
Interceptación (.)Superposiciones modales

4. Rutas de API

Manejadores de Rutas

MétodoUso
GETLeer datos
POSTCrear datos
PUT/PATCHActualizar datos
DELETEEliminar datos

Buenas Prácticas

  • Validar entrada con Zod
  • Devolver códigos de estado adecuados
  • Manejar errores de forma elegante
  • Usar runtime Edge cuando sea posible

5. Principios de Rendimiento

Optimización de Imágenes

  • Usar el componente next/image
  • Establecer prioridad para contenido visible inicial
  • Proporcionar placeholder borroso
  • Usar tamaños responsivos

Optimización del Bundle

  • Importaciones dinámicas para componentes pesados
  • División de código basada en rutas (automática)
  • Analizar con bundle analyzer

6. Metadatos

Estáticos vs Dinámicos

TipoUso
Exportación estáticaMetadatos fijos
generateMetadataDinámicos por ruta

Etiquetas Esenciales

  • title (50-60 caracteres)
  • description (150-160 caracteres)
  • Imágenes Open Graph
  • URL canónica

7. Estrategia de Caché

Capas de Caché

CapaControl
Solicitudopciones de fetch
Datosrevalidate/tags
Ruta completaconfiguración de ruta

Revalidación

MétodoUso
Basada en tiemporevalidate: 60
Bajo demandarevalidatePath/Tag
Sin cachéno-store

8. Acciones del Servidor

Casos de Uso

  • Envío de formularios
  • Mutaciones de datos
  • Disparadores de revalidación

Buenas Prácticas

  • Marcar con 'use server'
  • Validar todas las entradas
  • Devolver respuestas tipadas
  • Manejar errores

9. Anti-Patrones

❌ No Hacer✅ Hacer
'use client' en todos ladosServidor por defecto
Fetch en componentes clienteFetch en servidor
Omitir estados de cargaUsar loading.tsx
Ignorar límites de errorUsar error.tsx
Grandes bundles clienteImportaciones dinámicas

10. Estructura del Proyecto

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

Recuerda: Los Componentes de Servidor son el valor por defecto por una razón. Empieza ahí, añade cliente solo cuando sea necesario.

Cuándo Usar

Este skill es aplicable para ejecutar el flujo de trabajo o las acciones descritas en la visión general.

Limitaciones

  • Usa este skill solo cuando la tarea coincida claramente con el alcance descrito anteriormente.
  • No trates la salida como un sustituto de validación específica del entorno, pruebas o revisión de expertos.
  • Detente y pide aclaraciones si faltan entradas requeridas, permisos, límites de seguridad o criterios de éxito.

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.

Skills relacionados