Communitygithub.com

ComeOnOliver/skillshub

Utilizar al trabajar con tareas del App Router de Next.js: crear páginas en /app/, configurar rutas dinámicas ([id]/page.tsx), implementar layouts/plantillas anidadas (layout.tsx), optimizar componentes Server/Client, o construir páginas ERP basadas en roles (paneles de administrador/profesor/estudiante). Se activa automáticamente para todas las operaciones del directorio /app/, enrutamiento dinámico y características específicas del App Router.

¿Qué es skillshub?

Esta habilidad proporciona una guía experta para el desarrollo con el App Router de Next.js, enfocándose en la creación de páginas, enrutamiento dinámico, layouts anidados, optimización de componentes Server/Client y construcción de paneles ERP basados en roles. Está diseñada para desarrolladores que trabajan con la estructura de carpetas `app/` y necesitan implementar patrones modernos de Next.js de manera eficiente. La habilidad cubre desde la creación de páginas con componentes Server por defecto y obtención asíncrona de datos, hasta la implementación de rutas dinámicas con `generateMetadata()` y manejo de errores 404. Además, incluye guías para layouts y plantillas, la distinción entre componentes Server y Client, la integración de shadcn/ui para la interfaz de usuario, y la creación de paneles de control con gráficos KPI usando Recharts. También ofrece un árbol de decisiones para implementar rápidamente funcionalidades como paneles de administración, perfiles de estudiantes dinámicos, formularios interactivos y secciones de análisis. La habilidad es compatible con las herramientas de desarrollo de IA como Cursor, Codex y Claude Code, y se activa automáticamente cuando se trabajan con el App Router de Next.js.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/awais68/frontend-nextjs-app-router

Preguntar en tu IA favorita

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

Documentación

Experto en App Router de Next.js

Resumen

Guía experta para el desarrollo con el App Router de Next.js, que incluye creación de páginas, enrutamiento dinámico, layouts anidados, optimización de componentes Server/Client y paneles ERP basados en roles.

Capacidades Principales

1. Creación de Páginas (/app/.../page.tsx)

Reglas:

  • Usar Componentes Server por defecto (sin directiva 'use client')
  • Obtención asíncrona de datos con fetch() o consultas ORM directamente
  • Sin useEffect para la carga inicial de datos
  • Usar límites Suspense para estados de carga
  • Metadatos SEO a través de generateMetadata()

Plantilla:

// app/dashboard/page.tsx
import { Suspense } from 'react';
import { TaskList } from '@/components/TaskList';
import { TaskListSkeleton } from '@/components/TaskListSkeleton';

export const metadata = {
  title: 'Dashboard',
  description: 'Tu panel de gestión de tareas',
};

export default async function DashboardPage() {
  const tasks = await fetchTasks();

  return (
    <main className="p-4">
      <h1>Dashboard</h1>
      <Suspense fallback={<TaskListSkeleton />}>
        <TaskList initialTasks={tasks} />
      </Suspense>
    </main>
  );
}

2. Rutas Dinámicas ([slug]/page.tsx)

Cuándo usarlas:

  • Perfiles de estudiantes: app/students/[studentId]/page.tsx
  • Detalles de tareas: app/tasks/[taskId]/page.tsx
  • Páginas de cursos: app/courses/[courseId]/page.tsx

Reglas:

  • Extraer parámetros de la prop params (solo lectura)
  • Usar generateMetadata() para SEO
  • Manejar 404 con not-found.tsx

Plantilla:

// app/students/[studentId]/page.tsx
import { notFound } from 'next/navigation';

type Params = Promise<{ studentId: string }>;

export async function generateMetadata({ params }: { params: Params }) {
  const { studentId } = await params;
  const student = await getStudent(studentId);

  if (!student) return { title: 'Estudiante No Encontrado' };

  return {
    title: `${student.name} - Perfil de Estudiante`,
  };
}

export default async function StudentProfile({ params }: { params: Params }) {
  const { studentId } = await params;
  const student = await getStudent(studentId);

  if (!student) notFound();

  return <StudentProfileView student={student} />;
}

3. Rutas Paralelas (@folder)

Cuándo usarlas:

  • Variantes de dashboard: app/dashboard@(admin|teacher)/page.tsx
  • Layouts divididos: app/settings@(user|organization)/layout.tsx

Plantilla:

// app/dashboard/@admin/page.tsx - Dashboard de administrador
export default function AdminDashboard() {
  return <AdminPanel />;
}

// app/dashboard/@teacher/page.tsx - Dashboard de profesor
export default function TeacherDashboard() {
  return <TeacherPanel />;
}

4. Layouts y Plantillas

Layout Raíz (app/layout.tsx):

import { Providers } from '@/components/Providers';
import './globals.css';

export const metadata = {
  title: 'Todo Evolution',
  description: 'Gestión de tareas para educación',
};

export default function RootLayout({ children }: { children: React.ReactNode }) {
  return (
    <html lang="es">
      <body>
        <Providers>{children}</Providers>
      </body>
    </html>
  );
}

Layout Anidado (app/dashboard/layout.tsx):

import { DashboardNav } from '@/components/DashboardNav';

export default function DashboardLayout({
  children,
}: {
  children: React.ReactNode;
}) {
  return (
    <div className="flex min-h-screen">
      <DashboardNav />
      <main className="flex-1 p-6">{children}</main>
    </div>
  );
}

Plantilla (app/tasks/template.tsx):

// Se re-ejecuta en la navegación, conserva el estado del formulario
export default function TasksTemplate({ children }: { children: React.ReactNode }) {
  return (
    <div className="bg-gray-50 min-h-screen">
      <header className="bg-white shadow">
        <h1>Tareas</h1>
      </header>
      {children}
    </div>
  );
}

5. Componentes Server vs Client

Usar Componentes Server para:

  • Obtención de datos
  • Consultas directas a base de datos
  • Contenido estático
  • Operaciones solo del servidor

Usar Componentes Client ('use client') para:

  • APIs del navegador (window, localStorage)
  • Manejadores de eventos (onClick, onSubmit)
  • Hooks de React (useState, useEffect)
  • Gestión de estado (Zustand, Redux)
  • Interactividad
// Componente Server (por defecto)
export default async function TaskList() {
  const tasks = await fetchTasks(); // Consulta directa a DB
  return <div>{tasks.map(/* ... */)}</div>;
}

// Componente Client
'use client';
import { useTaskStore } from '@/store/tasks';

export function TaskFilter() {
  const { filter, setFilter } = useTaskStore();
  return <button onClick={() => setFilter('all')}>Todas las Tareas</button>;
}

6. Páginas ERP Basadas en Roles

Guardianes de Rol:

// app/admin/page.tsx
import { requireRole } from '@/lib/auth';
import { redirect } from 'next/navigation';

export default async function AdminPage() {
  const session = await getSession();

  if (session?.role !== 'admin') {
    redirect('/unauthorized');
  }

  return <AdminDashboard />;
}

Dashboard KPI (Recharts):

'use client';
import { BarChart, Bar, XAxis, YAxis, Tooltip } from 'recharts';

export function TaskKPIChart({ data }: { data: TaskStats[] }) {
  return (
    <BarChart width={600} height={300} data={data}>
      <XAxis dataKey="date" />
      <YAxis />
      <Tooltip />
      <Bar dataKey="completed" fill="#22c55e" />
    </BarChart>
  );
}

7. Estados de Error y Carga

Límite de Error (error.tsx):

'use client';
export default function Error({
  error,
  reset,
}: {
  error: Error & { digest?: string };
  reset: () => void;
}) {
  return (
    <div>
      <h2>¡Algo salió mal!</h2>
      <button onClick={reset}>Intentar de nuevo</button>
    </div>
  );
}

Estado de Carga (loading.tsx):

export default function Loading() {
  return <div className="animate-pulse">Cargando...</div>;
}

// O con Suspense:
export default async function Page() {
  return (
    <Suspense fallback={<Loading />}>
      <Content />
    </Suspense>
  );
}

8. Integración con shadcn/ui

Instalación:

npx shadcn@latest add button card input dialog

Uso en Componentes Server:

import { Button } from '@/components/ui/button';
import { Card, CardContent, CardHeader } from '@/components/ui/card';

export default async function TaskPage() {
  const tasks = await getTasks();

  return (
    <Card>
      <CardHeader>Tareas</CardHeader>
      <CardContent>
        {tasks.map(task => (
          <div key={task.id}>{task.title}</div>
        ))}
      </CardContent>
    </Card>
  );
}

Árbol de Decisión del Flujo de Trabajo

Solicitud del Usuario → Analizar → Ruta de Implementación

  1. "Crear página de Dashboard/Admin" → Componente Server con page.tsx → Obtención asíncrona de datos → Agregar layout.tsx si se necesita navegación

  2. "Perfil de estudiante dinámico" → Crear [studentId]/page.tsx → Extraer parámetros → Agregar generateMetadata() → Crear not-found.tsx si es necesario

  3. "Agregar layout compartido" → Crear layout.tsx en la carpeta destino → Envolver con providers si es necesario → Mantener el renderizado de children

  4. "Agregar formulario" → Componente con 'use client' → useState para datos del formulario → Server Action para el envío O ruta de API

  5. "Gráficos KPI/Análisis" → 'use client' para Recharts → Componente Server padre con obtención de datos → Pasar datos como props

Lista de Verificación de Calidad

Antes de marcar la tarea como completada:

  • Modo estricto de TypeScript habilitado
  • Componentes Server usados por defecto
  • 'use client' solo cuando sea necesario
  • generateMetadata() para SEO
  • Límites Suspense para datos asíncronos
  • Límites de error (error.tsx) donde sea necesario
  • Sin errores de hidratación
  • Rendimiento optimizado (sin renderizados bloqueantes)
  • Diseño responsive mobile-first
  • Accesible (etiquetas ARIA, navegación por teclado)

Patrones Comunes

Patrón 1: Mezcla de Componentes Server + Client

// Componente Server
export default async function Page() {
  const tasks = await fetchTasks();
  return <TaskList tasks={tasks} />; // Componente Client para interactividad
}

'use client';
function TaskList({ tasks }: { tasks: Task[] }) {
  const [filter, setFilter] = useState('all');
  const filtered = tasks.filter(/* ... */);
  return <div>{filtered.map(/* ... */)}</div>;
}

Patrón 2: Grupos de Rutas para Organización

app/
  (marketing)/     # Grupo: sin segmento de URL
    about/page.tsx
    contact/page.tsx
  (dashboard)/      # Grupo: sin segmento de URL
    layout.tsx
    page.tsx

Patrón 3: Rutas de API (Manejadores de Ruta)

// app/api/tasks/route.ts
import { NextResponse } from 'next/server';

export async function GET() {
  const tasks = await db.query.tasks.findMany();
  return NextResponse.json(tasks);
}

export async function POST(request: Request) {
  const body = await request.json();
  const task = await createTask(body);
  return NextResponse.json(task, { status: 201 });
}

Ejemplos de Disparo

  • "Crear página de Dashboard" → Generar app/dashboard/page.tsx con componente server
  • "Ruta dinámica de perfil de estudiante" → app/students/[studentId]/page.tsx con params y metadata
  • "Agregar layout compartido" → app/dashboard/layout.tsx con children
  • "Panel de administración con gráficos" → Componente Server + componente Client de gráficos
  • "Crear página de inicio de sesión" → Componente formulario con 'use client' + ruta de API
  • "Personalizar página 404" → app/not-found.tsx
  • "Manejar error" → app/dashboard/error.tsx

Referencias

Ver references/app-router-patterns.md para patrones avanzados y references/api-routes.md para ejemplos de manejadores de ruta.

Individual skills in this repo

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

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Skills relacionados