Reconstruí mi portfolio porque la web anterior ya no representaba el tipo de trabajo que quería enseñar. Era una sola página, dependía mucho de efectos visuales y cada proyecto nuevo exigía volver a tocar el HTML.
El cambio no consistió simplemente en sustituir una tecnología por otra. Pasé de una presentación cerrada a un sistema de contenido: páginas independientes, español e inglés, proyectos y artículos validados durante el build, sitemap generado y JavaScript reservado para las interacciones que lo necesitan.
A 10 de octubre de 2026, el build genera 80 páginas estáticas a partir de 20 artículos y 7 proyectos. Ese es el resultado medible. La parte importante es cómo llegué hasta ahí y qué problemas siguen sin resolverse por usar Astro.
El cambio, resumido con datos
| Aspecto | Portfolio anterior | Portfolio actual |
|---|---|---|
| Estructura pública | Una URL con secciones | 80 páginas estáticas en el último build |
| Proyectos | Contenido integrado en la página | 7 proyectos con rutas propias en español e inglés |
| Blog | No existía como sección publicable | 20 artículos y 3 hubs temáticos por idioma |
| Edición | Bloques de HTML modificados a mano | Entradas MDX con metadatos validados |
| JavaScript visual | Fondo de partículas con Three.js y varias animaciones | Scripts concretos para menú, tema, consentimiento, analítica y mejoras progresivas |
| Datos orgánicos comparables | No conservo un export equivalente | 4.370 impresiones y 24 clics en 92 días según el snapshot disponible de Search Console |
La última fila necesita contexto. El periodo medido va del 12 de junio al 11 de septiembre de 2026 y reúne todo el sitio. No demuestra que Astro causara esas impresiones ni permite una comparación directa con la versión anterior. Sí confirma algo más modesto: las páginas independientes están siendo descubiertas y mostradas para consultas distintas.
Qué limitaba realmente la web anterior
Una web de una sola página no es invisible para Google por definición. Mi problema era más concreto: proyectos, presentación y contacto compartían la misma URL, el mismo título y la misma descripción.
Eso dejaba poco espacio para explicar un proyecto con su contexto, enlazarlo directamente o hacer que respondiera a una búsqueda específica. Tampoco tenía una forma limpia de publicar artículos. Cada ampliación aumentaba el tamaño del mismo documento y hacía más frágil su mantenimiento.
La capa visual también pesaba demasiado en la decisión técnica. El fondo de partículas con Three.js llamaba la atención, pero no ayudaba a entender mejor mi trabajo. Necesitaba cargar y ejecutar código antes de aportar información útil. Al quitarlo no intenté hacer una web sin personalidad; decidí que la personalidad debía aparecer en el contenido, la tipografía y los detalles de interacción.
La arquitectura que uso ahora
La estructura actual separa contenido, rutas y presentación:
src/
├── content/blog/*.mdx
├── content/projects/*.mdx
├── pages/blog/[...slug].astro
├── pages/proyectos/[...slug].astro
├── pages/en/blog/[...slug].astro
└── pages/en/projects/[...slug].astroLos artículos y proyectos viven en colecciones. Sus esquemas comprueban campos como título, resumen, fecha, etiquetas, rol o stack antes de publicar. Las Content Collections de Astro no escriben el contenido por mí, pero impiden que una entrada incompleta llegue silenciosamente a producción.
Las rutas dinámicas usan getStaticPaths() para crear una página por entrada durante el build. El resultado que recibe el navegador es HTML generado de antemano, no una aplicación que necesita reconstruir cada vista en el cliente.
En cómo organizo Astro, MDX y contenido bilingüe explico la parte menos convencional: cada archivo contiene los bloques español e inglés y el build elimina el idioma que no corresponde a cada ruta. No es la única arquitectura posible. En este proyecto evita duplicar metadatos, pero obliga a comprobar que ambos textos avanzan juntos.
Las decisiones que más cambiaron el proyecto
Una URL para cada intención
Cada proyecto y cada artículo tiene una ruta estable, un título, una descripción, canonical, alternates de idioma y datos estructurados propios. El sitemap reúne esas URLs y ahora también existen hubs para Seguridad web, Astro y SEO, y Aprendizaje.
Eso no garantiza una posición en Google. Hace posible que cada página explique una idea concreta y reciba enlaces internos con contexto. En el SEO técnico de este portfolio detallo qué señales genero y cuáles no considero una garantía.
Contenido separado del layout
Antes, añadir un proyecto significaba copiar estructura HTML y volver a revisar etiquetas. Ahora añado una entrada MDX con datos conocidos y las plantillas resuelven la cabecera, breadcrumbs, schema, navegación y versión inglesa.
La ventaja no es escribir menos caracteres un día. Es reducir la cantidad de sitios que tengo que recordar seis meses después. Si cambio cómo se presenta la fecha de un artículo, modifico la plantilla, no veinte archivos.
JavaScript cuando aporta algo
Astro no elimina JavaScript por arte de magia. El proyecto sigue usando scripts para el menú móvil, el selector de tema, el consentimiento, la analítica y algunas mejoras de desplazamiento.
La diferencia es que ya no necesito JavaScript para que aparezca el contenido principal. Incluso el desplazamiento suave se carga después de la primera interacción y se omite si la persona prefiere reducir movimiento. La navegación y la lectura siguen funcionando como HTML normal.
Qué puedo afirmar sobre el rendimiento
Puedo afirmar que eliminé Three.js y el fondo de partículas, que reduje las animaciones permanentes y que la página principal se genera como HTML estático. También puedo inspeccionar qué scripts produce el build actual.
No puedo afirmar que la nueva web sea un porcentaje concreto más rápida porque no conservé una medición equivalente de la versión anterior: mismo dispositivo, misma red, mismo hosting y misma herramienta. Un Lighthouse actual frente a un recuerdo de la web antigua no sería un antes y después fiable.
Ese hueco es uno de los aprendizajes del proyecto. Si volviera a empezar, guardaría antes de migrar:
- Capturas de Lighthouse y WebPageTest en móvil y escritorio.
- Peso transferido por tipo de recurso.
- LCP, CLS e INP de campo si hubiera tráfico suficiente.
- Número de peticiones y JavaScript ejecutado en la carga inicial.
- Tiempo real necesario para publicar un proyecto nuevo.
La arquitectura actual facilita mejorar esas métricas, pero no sustituye medirlas.
El resultado que sí puedo comprobar
El resultado más visible no es una puntuación: es que el sitio ha dejado de estar cerrado.
- El build actual genera 80 páginas sin mantener 80 documentos HTML a mano.
- Los 20 artículos y 7 proyectos comparten esquemas y plantillas.
- Español e inglés tienen rutas, canonical y alternates coherentes.
- Los artículos pueden agruparse en rutas temáticas y enlazarse entre sí.
- Un error de metadatos puede detener el build antes de llegar a producción.
El snapshot propio de Search Console añade una señal externa: entre el 12 de junio y el 11 de septiembre de 2026 registró 4.370 impresiones, 24 clics y una posición media de 17,59. Son cifras pequeñas y el CTR de 0,55 % deja trabajo pendiente. Prefiero contarlas así a presentarlas como un éxito sin matices.
También muestran por qué la arquitectura importa. Las impresiones no proceden solo de la home: aparecen artículos y páginas de proyecto en español e inglés. La estructura permite esa superficie de búsqueda; el contenido y su calidad deciden hasta dónde llega.
Lo que Astro no resolvió por mí
Astro fue una buena herramienta para este caso, pero no tomó las decisiones difíciles:
- No decidió qué proyectos merecían una página.
- No escribió títulos útiles ni descripciones específicas.
- No convirtió automáticamente la web en accesible o segura.
- No evitó que algunas piezas nacieran sin suficientes fuentes o pruebas.
- No creó un flujo editorial sencillo para una persona que no use Git.
Eso último importa. Para mi portfolio, MDX y Git encajan porque yo desarrollo y publico. Para un cliente que edita cada semana, un CMS puede ser una decisión mejor aunque añada infraestructura. La tecnología correcta depende del mantenimiento real, no de cuál genera el HTML más limpio.
Qué haría distinto ahora
Habría medido la web anterior antes de borrarla. También habría definido desde el principio el mapa bilingüe, la estructura de contenido y las evidencias que quería conservar de cada proyecto.
No cambiaría la decisión principal: separar el contenido en páginas y usar un build estático encaja con un portfolio que necesita explicar trabajo, publicar artículos y mantenerse con pocas piezas de servidor.
La reconstrucción ha cumplido su objetivo cuando puedo añadir una idea sin volver a diseñar la web entera. Ese es el cambio que más valoro: el portfolio ya no es una pieza terminada que envejece, sino un sistema que puedo seguir alimentando.
Las mismas decisiones sobre estructura, rendimiento y mantenimiento forman parte de mi servicio de desarrollo web con Astro cuando el proyecto encaja con este tipo de arquitectura.