react-para-torpes

React para torpes: de cero a tu primera app en 30 días con React 19 y TypeScript

CI React 19 TypeScript Next.js 16 Tailwind CSS 4 pnpm Licencia MIT

Un concepto por día. Código que corre en el navegador. Errores típicos explicados.


Qué es

React para torpes es un curso gratuito y en español para aprender React 19 con TypeScript en 30 días, más una semana extra de Next.js. Está pensado para quien empieza desde cero y quiere avanzar sin agobios.

El repositorio incluye el curso y el sitio web que lo sirve:

El plan

Cinco libros, uno por semana: fundamentos, profundizando, hooks y contexto, avanzado y bonus de Next.js

Semana Días Tema Lo que construyes
1 1 a 7 Fundamentos Entorno con Vite, JSX, props, useState, eventos y una lista de tareas
2 8 a 14 Profundizando Listas, formularios con validación, elevación de estado y un proyecto con persistencia
3 15 a 21 Hooks y contexto useEffect, hooks propios, Context, useReducer, useMemo y un glosario con paginación
4 22 a 30 Avanzado React Router, Redux Toolkit, APIs, tests con Vitest y un CRUD final
5 31 a 35 Bonus: Next.js App Router, Server Components, datos en servidor y despliegue estático

Cada lección sigue el mismo formato:

  1. Concepto, con una analogía cotidiana.
  2. Paso a paso, en pasos numerados.
  3. Pruébalo en vivo, con el editor al lado.
  4. Error típico, antes de que tropieces con él.
  5. Ejercicio con criterios que marcas tú, y su solución oculta.
  6. Resumen y lecturas de la documentación oficial.

Empezar

Requisitos: Node 20 o superior y pnpm.

pnpm install
pnpm dev          # sitio en http://localhost:3000
pnpm examples     # galería de ejemplos con Vite

Otros comandos útiles:

pnpm typecheck    # TypeScript en todo el monorepo
pnpm lint
pnpm test         # tests de los ejemplos y del sitio
pnpm build        # genera web/out, el sitio estático
pnpm --filter web check:content   # valida frontmatter, MDX y ejemplos referenciados

Estructura

content/     lecciones en MDX (content/semanaN/dia-XX.mdx)
examples/    proyecto Vite con todos los ejemplos y sus tests
web/         sitio Next.js (App Router, export estático) con Tailwind CSS
docs/        recursos gráficos del repositorio

Los fragmentos que ves en el sitio se leen directamente de examples/src. Si un ejemplo deja de compilar, falla el CI.

Tecnología

Capa Herramientas
Sitio Next.js 16 (App Router, export estático), React 19, TypeScript
Estilos Tailwind CSS 4 con tokens en @theme, tema oscuro
Contenido MDX con next-mdx-remote, resaltado con Shiki
Editor en vivo Sandpack
Ejemplos Vite, React Router, Redux Toolkit
Calidad ESLint, Vitest, Testing Library, GitHub Actions
Gestor de paquetes pnpm workspaces

Despliegue

El sitio se exporta como HTML estático y deploy.yml lo publica en GitHub Pages con NEXT_PUBLIC_BASE_PATH=/react-para-torpes. Para activarlo, elige GitHub Actions como fuente en los ajustes de Pages del repositorio.

Contribuir

Las correcciones de contenido, los ejemplos nuevos y las mejoras del sitio son bienvenidas. Lee CONTRIBUTING.md para ver el flujo de trabajo y el formato de las lecciones.

Licencia

MIT