IA
Aprende IA
Chat con RAG
Módulo 3Intermedio40 min
🚀

Crear Proyectos Next.js con Claude Code

Aprende a crear aplicaciones web profesionales con Next.js 16, Tailwind CSS y Shadcn UI usando Claude Code como tu asistente de desarrollo.

Progreso0/11 secciones
0 XP
1

¿Por qué Next.js?

1/11

Next.js te da todo lo que necesitas para una aplicación web profesional:

  • Rendimiento — Pre-renderizado automático para cargas ultrarrápidas
  • SEO — Las páginas se generan en el servidor, Google las indexa perfectamente
  • Full-stack — Puedes crear tanto el frontend como el backend en el mismo proyecto
  • Ecosistema — Miles de librerías compatibles y una comunidad enorme
  • App Router — Sistema de navegación moderno y potente

Nota: No necesitas saber React ni JavaScript avanzado. Claude Code hará el trabajo técnico mientras tú diriges el proyecto.

2

Setup Inicial: Lo que Necesitas

2/11

Antes de empezar, verifica que tienes instalado:

# Verificar Node.js (necesitas v18 o superior)
node --version

# Verificar npm
npm --version

Si no tienes Node.js, descárgalo desde nodejs.org e instala la versión LTS.

3

Paso 1: Crear el Proyecto Base

3/11

Abre tu terminal y ejecuta:

# Crear el proyecto con todas las opciones recomendadas
npx create-next-app@latest mi-app --typescript --tailwind --app

# Navegar al proyecto
cd mi-app

# Iniciar Claude Code
claude

Durante la creación, acepta los valores predeterminados. Claude Code se encargará de las configuraciones específicas después.

Estructura que se crea:

mi-app/
├── app/
│   ├── layout.tsx      ← Layout principal (HTML base)
│   ├── page.tsx        ← Página de inicio (/)
│   └── globals.css     ← Estilos globales
├── public/             ← Archivos estáticos (imágenes, etc.)
├── next.config.ts      ← Configuración de Next.js
├── tailwind.config.ts  ← Configuración de Tailwind
└── package.json        ← Dependencias del proyecto
4

Paso 2: Integrar Shadcn UI

4/11

Shadcn UI es una colección de componentes de interfaz pre-diseñados que puedes personalizar completamente. Con Claude Code, la instalación es simple:

# En tu terminal (no en Claude Code)
npx shadcn@latest init

Responde las preguntas:

  • Style: Default
  • Base color: Slate
  • CSS variables: Yes

Ahora dile a Claude Code:

Instala los componentes de Shadcn que vamos a necesitar:
Button, Card, Input, Dialog, Sheet y NavigationMenu

Claude Code ejecutará los comandos de instalación automáticamente.

5

Paso 3: Estructura de un Proyecto Real

5/11

Vamos a crear una aplicación: un Dashboard de tareas personal.

Definir la arquitectura con Claude Code:

Vamos a crear un dashboard de tareas con las siguientes páginas y funcionalidades:

PÁGINAS:
- / → Dashboard principal con resumen y tareas recientes
- /tareas → Lista completa de tareas con filtros
- /tareas/nueva → Formulario para crear tarea
- /estadisticas → Gráficos de productividad

FUNCIONALIDADES:
- Crear, editar y eliminar tareas
- Categorías: Trabajo, Personal, Estudio
- Prioridad: Alta, Media, Baja
- Estado: Pendiente, En Progreso, Completada
- Filtrar y buscar tareas
- Datos guardados en localStorage (sin base de datos por ahora)

DISEÑO:
- Dark mode siempre activo
- Colores: fondo #0a0a0f, superficie #111118, violeta #7c3aed, cyan #06b6d4
- Layout con sidebar en desktop, nav inferior en móvil
- Componentes de Shadcn UI para formularios y botones

¿Puedes empezar creando la estructura de carpetas y el layout principal?

Layout con sidebar (prompt para Claude Code):

Crea el layout principal en app/layout.tsx con:
- Un sidebar fijo en desktop (250px) con:
  - Logo "TaskFlow" en la parte superior
  - Links de navegación con iconos (usa lucide-react)
  - Indicador de ruta activa
- En móvil: sidebar oculto, bottom navigation con los mismos links
- Área de contenido principal que ocupe el resto del espacio
- Fondo #0a0a0f, sidebar #111118

Usa TypeScript y los componentes de Shadcn que ya están instalados.
6

Paso 4: Tu Primer Componente con Claude Code

6/11

Un componente en Next.js es un bloque reutilizable de interfaz. Vamos a crear uno paso a paso.

Componente: Tarjeta de tarea

Crea el componente components/TaskCard.tsx que muestre una tarea individual.
El componente debe recibir estas propiedades (props):

interface Task {
  id: string
  titulo: string
  descripcion: string
  categoria: 'Trabajo' | 'Personal' | 'Estudio'
  prioridad: 'Alta' | 'Media' | 'Baja'
  estado: 'Pendiente' | 'En Progreso' | 'Completada'
  fechaLimite?: string
}

La tarjeta debe mostrar:
- Título en grande
- Badge de categoría (color diferente para cada una)
- Badge de prioridad (rojo=Alta, amarillo=Media, verde=Baja)
- Badge de estado
- Descripción breve (máximo 2 líneas con ellipsis)
- Fecha límite si existe
- Botones de acción: Editar, Completar, Eliminar

Usa Shadcn Card, Badge y Button. Diseño dark mode.

Integrar el componente en una página:

Crea la página app/tareas/page.tsx que:
1. Tenga datos de ejemplo hardcodeados (5 tareas de ejemplo)
2. Use el componente TaskCard para mostrar cada tarea
3. Tenga una barra de búsqueda y filtros por categoría
4. Un botón "Nueva Tarea" que redirija a /tareas/nueva
5. Layout de grid: 3 columnas en desktop, 2 en tablet, 1 en móvil
7

Paso 5: Agregar Funcionalidad Real

7/11

Ahora hacemos que los datos persistan usando el estado de React y localStorage:

Crea el archivo lib/tasks-store.ts con:
- Un array de tareas de ejemplo como estado inicial
- Funciones para: getTasks(), createTask(), updateTask(), deleteTask()
- Persistencia automática en localStorage
- Tipos TypeScript para todo

Luego actualiza app/tareas/page.tsx para:
- Usar el store en lugar de los datos hardcodeados
- Conectar el botón "Eliminar" para borrar tareas realmente
- Conectar los badges de estado para cambiar el estado al hacer click
8

Comandos Útiles Durante el Desarrollo

8/11

Mientras trabajas en tu proyecto, estos comandos son tus mejores aliados:

# Iniciar el servidor de desarrollo (ver cambios en tiempo real)
npm run dev
# Abre http://localhost:3000 en tu navegador

# Verificar que no hay errores de TypeScript
npm run type-check

# Preparar para producción
npm run build

# Ver errores de estilo
npm run lint

Pedirle ayuda a Claude Code con errores:

Al ejecutar "npm run build" me sale este error:
[pega aquí el error completo]

¿Puedes identificar qué archivo está causando el problema y corregirlo?
9

El Flujo de Desarrollo Profesional

9/11

Con Claude Code, el proceso de desarrollo sigue este patrón:

SEMANA 1: Define la arquitectura
  └─ "Diseña la estructura de archivos para una app de [tu idea]"

DÍA A DÍA: Construye feature por feature
  ├─ "Crea el componente para [función específica]"
  ├─ "Conecta [componente A] con [componente B]"
  └─ "Añade validación a [formulario]"

CUANDO ALGO FALLA: Debug con contexto
  └─ "Al hacer [acción], sale el error [error]. ¿Qué archivo hay que cambiar?"

ANTES DE PUBLICAR: Revisión final
  └─ "Revisa todo el proyecto. ¿Hay errores de TypeScript o código duplicado?"
10

Publicar tu Aplicación

10/11

Cuando tu app esté lista, puedes publicarla gratis en Vercel:

# Instalar Vercel CLI
npm install -g vercel

# Publicar con un comando
vercel

O dile a Claude Code:

Quiero publicar esta app en Vercel. ¿Qué pasos necesito seguir?
¿Necesito configurar alguna variable de entorno?
11

Resumen del Módulo 3

11/11

¡Felicitaciones! Ahora sabes cómo:

  • Crear un proyecto Next.js 16 con TypeScript y Tailwind CSS
  • Integrar Shadcn UI para componentes profesionales
  • Diseñar la arquitectura de una aplicación real con Claude Code
  • Crear componentes React mediante prompts en lenguaje natural
  • Agregar funcionalidad como persistencia de datos y filtros
  • Publicar tu aplicación para que el mundo la vea

Has completado los tres módulos de Aprende IA. Ahora tienes las herramientas para construir cualquier proyecto que imagines — sin necesidad de años de experiencia en programación.

¿Cuál es tu próximo proyecto? Usa el chat de esta plataforma para hacer preguntas sobre lo que aprendiste. ¡Estamos aquí para ayudarte!

Módulo anteriorclaude archivos
¡Curso completado!Volver al inicio →