Este proyecto es una página web que presenta mi Curriculum Vitae, creada casi enteramente utilizando Inteligencia Artificial. El objetivo es demostrar el potencial de la IA como herramienta de apoyo en el desarrollo web y la creación de contenido.
- Sitio estático: sin JavaScript de framework en el navegador
- Diseño moderno y responsivo, con estilos de impresión
- Español e inglés, cada uno con su propia URL indexable
- Tema claro y oscuro, según el navegador o a golpe de botón
- Sistema de diseño por tokens: cambiar el aspecto no obliga a tocar componentes
- Sección de proyectos con imágenes y enlaces
- Contenido en Markdown, renderizado durante el build
- Botón para guardar el CV en PDF, aprovechando los estilos de impresión
- Tipado con TypeScript y verificado con pruebas end-to-end en Chromium y WebKit
- Lighthouse en 100 en las cinco categorías, comprobado en cada despliegue
- Astro — generación estática
- Tailwind CSS 4 — utilidades sobre tokens propios
- TypeScript
- Playwright — pruebas end-to-end y de regresión visual
- Desplegado en Netlify
npm install
npm run dev # servidor de desarrollo en http://localhost:4321| Comando | Qué hace |
|---|---|
npm run dev |
Servidor de desarrollo con recarga en caliente |
npm run build |
Genera el sitio estático en dist/ |
npm run preview |
Sirve el resultado de build en local |
npm run check |
Comprueba tipos y plantillas Astro |
npm test |
Pruebas end-to-end (compila y arranca el sitio solo) |
npm run test:ui |
Las mismas pruebas en modo interactivo |
npm run audit:lighthouse |
Audita el sitio construido y falla si baja de 100 |
Las pruebas necesitan los navegadores de Playwright (npx playwright install
la primera vez). Se ejecutan en Chromium y en WebKit, el motor de Safari:
un fallo de carga de imágenes que sólo se daba ahí se coló en su día por probar
únicamente en Chromium. Las de regresión visual sólo corren en Chromium, porque
sus capturas dependen del entorno que las genera.
En entornos que ya traen Chromium se puede evitar la descarga con
CHROMIUM_PATH=/ruta/al/chrome npm test. La auditoría de Lighthouse admite
CHROME_PATH de la misma manera.
Todo el texto del CV vive en src/i18n/es.json y src/i18n/en.json. No hay
que tocar código para actualizarlo: añade un puesto, un proyecto o una
habilidad en ambos ficheros y se refleja al compilar. Las pruebas recorren esos
diccionarios, así que verifican solas el contenido nuevo.
Los datos de contacto están en src/data/contact.ts, aparte porque no se
traducen.
Los textos admiten Markdown en línea (**negrita**, *cursiva*, enlaces), que
se convierte a HTML durante el build.
Van en src/assets/ (las de proyectos, en src/assets/projects/), no en
public/. Astro las procesa durante el build: las convierte a WebP, genera
varios tamaños y sirve el que corresponda a cada pantalla.
En los diccionarios se siguen nombrando por su fichero, como
"image": "/cloud-monitor.png"; basta con dejar el archivo en
src/assets/projects/ con ese nombre. Si no aparece, el build falla en vez de
publicar una imagen rota.
En public/ solo queda el favicon, porque debe servirse tal cual y sin
renombrar.
- Crea
src/i18n/<código>.jsoncopiando la estructura dees.json. - Regístralo en
src/i18n/utils.ts, en el objetotranslations. - Añade la ruta:
src/pages/<código>/index.astro, igual quesrc/pages/en/index.astro. - Añade el idioma a
localesenastro.config.mjs.
El español vive en la raíz (/) y el resto de idiomas bajo su prefijo
(/en/). El selector recuerda la elección en localStorage.
La web sigue la preferencia del navegador y añade un botón para cambiar de tema, que recuerda la elección. En claro, el cuerpo usa la paleta de un IDE con tema claro y la cabecera conserva su verde de terminal; en oscuro, ese verde pasa a ser la marca de toda la página.
El color, la tipografía, los radios y las sombras salen de los tokens de
src/styles/globals.css.
Ver docs/design-tokens.md para la lista completa de
tokens y cómo crear un tema nuevo.
El sitio se compila en GitHub Actions y se sube ya construido a Netlify con su
CLI (.github/workflows/deploy.yml). Nada se publica si fallan los tipos, las
pruebas o la auditoría de Lighthouse. Los push a main van a producción y el
resto de ramas generan una previsualización.
netlify.toml fija las cabeceras de seguridad, incluida una Content-Security-
Policy, y el cacheado de los recursos con huella en el nombre.
Dependabot revisa las dependencias cada semana y las de GitHub Actions cada mes.
docs/design-tokens.md— sistema de diseñodocs/migracion-astro.md— cómo y por qué se migró desde React/Vite
El proyecto se desarrolló principalmente a través de prompts a sistemas de IA: conversión inicial de un documento Word a estructura web, refinamiento del diseño, división en componentes, soporte multiidioma, paso del contenido a Markdown, migración a TypeScript y, por último, migración de React a Astro con un sistema de diseño basado en tokens.
Ver el archivo LICENSE.
Creado con ❤️ y 🤖 por Rubén Álvarez