1. Introducción
El PDF del documento está AQUÍ.
Los códigos del documento están AQUÍ.
Este documento es un producto de Claude, la IA de Anthropic. Sigue al curso “Introducción paso a paso al framework web NestJS”, del cual cambia la perspectiva:
- en el curso [NestJS], el servidor genera las páginas HTML (motor de vistas [Handlebars]); el navegador se limita a mostrarlas;
- en este curso, las páginas se generan en el navegador mediante una aplicación [React]; el servidor, reducido ahora a un simple servidor JSON, solo proporciona datos.
Sin embargo, las páginas de la aplicación permanecen sin cambios: son las de la aplicación [RdvMedecins] ya presentada con los otros frameworks (inicio de sesión con CAPTCHA, agenda del médico, ventana de citas, portal del paciente, gestión de médicos y clientes, creación de cuentas, francés e inglés).
Este documento sigue la misma estructura que sus predecesores: primero, numerosos ejemplos breves, cada uno centrado en un concepto específico de [React], seguidos de un caso de estudio completo —el cliente [React] de la aplicación [RdvMedecins]— con todos los archivos comentados. Sigue la misma estructura que los cursos *Introducción paso a paso al framework Vue.js* e *Introducción paso a paso al framework Angular*: los lectores familiarizados con [Vue.js] o [Angular] encontrarán los mismos ejemplos, escritos al estilo de [React]: 25 ejemplos, numerados como los del curso [Angular].
Ya existe un curso sobre este tema: Un ejemplo cliente/servidor con React / NestJS (2026), que abarca tanto el servidor como el cliente. Este documento se diferencia de aquel en su enfoque: el servidor se trata como una caja negra, y solo nos interesan la API y el JSON; aprendemos [React] paso a paso antes de abordar el cliente completo.
1.1. El papel de React en una aplicación web
La aplicación tiene dos partes, que se comunican entre sí solo mediante solicitudes:

- 1: la aplicación [React], que se ejecuta en el navegador, envía una solicitud HTTP al servidor, por ejemplo, [GET /api/schedule?doctorId=1&day=2026-10-05];
- 2: el servidor responde con datos JSON: la agenda de ese médico para ese día. No genera ninguna página;
- 3: con estos datos, [React] actualiza la página mostrada en el navegador sin recargarla.
El siguiente diagrama compara las dos arquitecturas:

El navegador carga una única página HTML, casi vacía, al iniciar. Todo lo demás lo genera el código [JavaScript]: esto se conoce como aplicación de página única (SPA, por [Single Page Application]). Cuando el usuario hace clic en un enlace interno, no se solicita ninguna página al servidor: el enrutador cambia la URL mostrada y reemplaza el contenido de la página.
[React] es una biblioteca creada por [Facebook] (hoy [Meta]) y lanzada en 2013. Actualmente es la biblioteca más utilizada para construir interfaces web. Se basa en tres conceptos:
- componentes: la interfaz se descompone en partes reutilizables (una barra de navegación, un campo de formulario, una ventana de confirmación, etc.). Un componente [React] es una simple función de [JavaScript] (o [TypeScript]) que devuelve lo que debe mostrarse, escrita en JSX, una sintaxis que combina HTML y [JavaScript];
- el estado y el renderizado declarativo: los datos de un componente se almacenan en su estado ([useState]). Cuando el estado cambia, [React] llama a la función del componente, compara el resultado con el anterior y actualiza automáticamente lo que haya cambiado en la página. Nunca escribimos código que modifique directamente la página: describimos la página en función de su estado;
- hooks: funciones ([useState], [useEffect], [useContext]...) mediante las cuales un componente accede a los mecanismos de [React]: estado, efectos secundarios y datos compartidos. Usted puede escribir sus propios hooks para reutilizar un comportamiento.
A diferencia de [Angular], [React] no es un framework "todo en uno": es una biblioteca de renderizado. El enrutador, los formularios, el cliente HTTP, la traducción y el estado compartido los proporcionan otras bibliotecas, elegidas por el desarrollador. Este curso utiliza las más comunes: [React Router] (el enrutador), [React Hook Form] (un ejemplo de biblioteca de formularios), [TanStack Query] (lectura de datos del servidor), [Zustand] (estado compartido) e [i18next] (idiomas). La herramienta de compilación es [Vite].
Usaremos [React] 19, con su implementación más reciente: componentes de función y hooks (los antiguos componentes escritos como clases ya no se usan), acciones de formulario ([useActionState]), [use()] y [<Suspense>], [<title>] colocado por un componente, [useEffectEvent] y [<Activity>] (React 19.2).
1.2. Herramientas utilizadas
Los ejemplos se escribieron y probaron con las siguientes herramientas (las instrucciones de instalación se encuentran en el apéndice):
- [Node.js] 24 (o al menos 22.22: es un requisito de [React Router] 8) y su administrador de paquetes [npm];
- el editor [Visual Studio Code], que incluye [TypeScript] y JSX sin necesidad de extensiones adicionales;
- un navegador reciente ([Chrome], [Firefox], [Edge]), si es posible con la extensión [React Developer Tools];
- la herramienta de línea de comandos [curl], que muestra las respuestas HTTP sin procesar;
- el SGBD [MySQL] (o [MariaDB]), por ejemplo, el de [Laragon] en [Windows]: es necesario para el servidor JSON, como se describe en el capítulo que lo presenta.
Las bibliotecas son las de los archivos [package.json]: [React] 19.3, [React Router] 8.4, [Vite] 8.3, [TypeScript] 6.0, [React Hook Form] 7.89, [TanStack Query] 5.104, [Zustand] 5.0, [i18next] 26 y [react-i18next] 17, [Bootstrap] 5.3.
1.3. Ejemplos
Los códigos del documento se organizan en tres carpetas:
La carpeta examples contiene veinticinco aplicaciones pequeñas, una por ejemplo, que comparten las mismas bibliotecas:
Instale las bibliotecas una sola vez, en una consola abierta en la carpeta [examples-react] (en [VS Code]: menú Terminal / Nueva terminal):
Luego ejecute un ejemplo escribiendo su nombre:
El servidor de desarrollo de [Vite] sirve el ejemplo en el puerto 5173: ábralo en http://localhost:5173/. No es necesario reiniciar este servidor cuando se modifica un archivo: cada archivo guardado se vuelve a compilar de inmediato y la página del navegador se actualiza automáticamente, normalmente sin siquiera perder su estado. Deténgalo escribiendo [Ctrl-C] en la consola antes de ejecutar el siguiente ejemplo (solo un ejemplo a la vez puede ocupar el puerto 5173).
Los ejemplos 22 a 25 consultan los servidores JSON y [RdvMedecins]: deberá haberlos instalado e iniciado, como se explica en el capítulo dedicado a ellos.
1.4. Contenido del documento
Capítulo | Contenido | Ejemplos |
Primeros pasos | Una aplicación, estado, JSX, eventos, campos controlados, useReducer, validación, React Hook Form, formato | 01–09 |
Componentes | props, funciones pasadas hacia el padre, composición (children, render props), ciclo de vida y efectos, contextos, hooks personalizados, cuadro de diálogo de confirmación | 10 a 16 |
Enrutamiento | React Router, guardias de navegación (middleware) | 17 y 18 |
Operaciones asíncronas y estado compartido | Temporizadores, antirrebote, respuestas caducadas, use() y Suspense, Zustand | 19 y 20 |
Internacionalización | Una aplicación en francés e inglés (i18next) | 21 |
El servidor: una caja negra | Instalación del servidor JSON, su API, ejemplos con curl | - |
Interacción con el servidor | fetch, conexión y cookies, acciones de formulario, la capa de acceso a la API, TanStack Query, errores del servidor | 22–25 |
Caso de estudio | El cliente React de la aplicación RdvMedecins | - |
Despliegue | El cliente compilado, servido por el servidor JSON | - |
Cada ejemplo se presenta con su código completo, comentado línea por línea, y una captura de pantalla de su ejecución. El propio código está ampliamente comentado: estos comentarios forman parte del curso.