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 simplemente las muestra;
- en este curso, las páginas se generan en el navegador mediante una aplicación [Vue.js]; el servidor, ahora reducido 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).
El documento sigue la misma estructura que sus predecesores: primero, numerosos ejemplos breves, cada uno centrado en un concepto específico de [Vue.js], seguidos de un caso de estudio completo —el cliente [Vue.js] de la aplicación [RdvMedecins]— con todos los archivos completamente comentados.
Ya existen dos cursos disponibles sobre [Vue.js]: “Introducción al framework VUE.JS mediante ejemplos” (2019), escrito para [Vue.js] 2, y “Un ejemplo cliente/servidor con Vue.js / NestJS (2026), que abarca tanto el servidor como el cliente. Este documento se diferencia de aquellos en su enfoque: el servidor se trata como una caja negra, de la cual solo nos interesan la API y el JSON, y aprendemos [Vue.js] paso a paso antes de abordar el cliente completo.
1.1. El papel de Vue.js en una aplicación web
La aplicación tiene dos partes, que se comunican entre sí únicamente mediante solicitudes HTTP:

- 1: La aplicación [Vue.js], 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, [Vue.js] actualiza la página mostrada en el navegador sin recargarla.
El siguiente diagrama compara las dos arquitecturas:

Al inicio, el navegador carga solo una única página HTML, casi vacía. Todo lo demás lo genera 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 de [Vue.js] cambia la URL mostrada y reemplaza el contenido de la página.
[Vue.js] es un framework [JavaScript] creado en 2014 por Evan You. Se basa en dos ideas:
- componentes: la interfaz se divide en piezas reutilizables (una barra de navegación, un campo de formulario, una ventana de confirmación, etc.), cada una escrita en un archivo [.vue] que combina su HTML, su código y su estilo;
- reactividad: los datos de un componente son “observados”. Cuando alguno cambia, [Vue.js] actualiza automáticamente las partes de la página que lo muestran. Nunca escribimos código que modifique directamente la página.
Usaremos [Vue.js] 3, escrito en [TypeScript], con su versión más reciente: la Composition API y la etiqueta [<script setup>].
1.2. Herramientas utilizadas
Los ejemplos se escribieron y probaron con las siguientes herramientas (su instalación se describe en el apéndice):
- [Node.js] 22 (o al menos 20.19) y su administrador de paquetes [npm];
- el editor [Visual Studio Code], con la extensión [Vue (Official)];
- un navegador reciente ([Chrome], [Firefox], [Edge]), si es posible con la extensión [Vue.js devtools];
- 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]: [Vue.js] 3.5, [Vite] 7 (la herramienta de desarrollo y compilación), [vue-router] 4 (el enrutador), [Pinia] 3 (estado compartido), [vue-i18n] 11 (idiomas), [TypeScript] 5.9, [Bootstrap] 5.3.
1.3. Ejemplos
Los códigos del documento están organizados en tres carpetas:
La carpeta examples contiene una subcarpeta por ejemplo:
Todos los ejemplos comparten las mismas bibliotecas, que se declaran en [examples-vuejs/package.json]. Se instalan una sola vez, en una consola abierta en la carpeta [examples-vuejs] (en [VS Code]: menú Terminal / Nueva terminal):
Luego, inicie el servidor de desarrollo de [Vite]:
Un solo servidor, en el puerto 5173, sirve los veinte ejemplos. La dirección http://localhost:5173/ muestra su resumen:

Puede navegar de un ejemplo a otro siguiendo los enlaces (http://localhost:5173/01-first-application/, http://localhost:5173/02-reactivity/...). No es necesario reiniciar el servidor de [Vite]: cada archivo que se modifica y se guarda se recompila de inmediato, y la página del navegador se actualiza automáticamente. Puede detenerlo ingresando [Ctrl-C] en la consola.
Los ejemplos 17 a 20 consultan los servidores JSON y [RdvMedecins]: deberá tenerlos instalados y en ejecución, como se explica en el capítulo dedicado a ellos.
1.4. Contenido del documento
Capítulo | Contenido | Ejemplos |
Primeros pasos | Un proyecto Vite, reactividad, directivas, eventos, formularios, validación | 01 a 06 |
Componentes | props, eventos, v-model, slots, ciclo de vida, composables, cuadro de diálogo de confirmación | 07–12 |
Enrutamiento | el enrutador, las guardias de navegación | 13 y 14 |
Estado compartido | Stores de Pinia | 15 |
Internacionalización | Una aplicación en francés e inglés | 16 |
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; la capa de acceso a la API; errores del servidor | 17–20 |
Caso de estudio | El cliente Vue.js 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.