Migración a Astro y Next.js - WordPress a Headless

Migración a Astro y Next.js - WordPress a Headless

8 min de lectura
Guía

Migro el frontend de sitios WordPress a Astro o Next.js y dejo la edición donde está: en WordPress. Soy Mariusz Szatkowski, trabajo con WordPress desde 2006 y hago cada migración yo mismo, sin equipo ni subcontratas. Antes de proponer un cambio de framework mido dónde está el problema, porque a menudo basta con arreglar la caché, las imágenes o un plugin que lanza consultas en cada petición.

#¿Quién realiza la migración de WordPress a Astro y Next.js?

Yo, en persona. Escribo el código, hago las pruebas y respondo de lo que se entrega. Si el proyecto va más allá de WordPress, mira la página de desarrollador de software.

#¿Qué incluye la migración?

Trasladar la capa pública a Astro o Next.js, reconstruir plantillas y componentes a partir del diseño que tú aportas, conectar el contenido de WordPress por REST o GraphQL, mover formularios e integraciones y redirigir las URL antiguas. El panel de edición, los roles y el flujo de publicación se quedan en WordPress, salvo que acordemos otra cosa.

#¿Dónde trabajo?

En remoto desde Gdynia, Polonia, en la misma zona horaria que España peninsular. Me comunico por correo, documentos y el repositorio. Facturo como B2B con NIF-IVA europeo PL7393037445 e inversión del sujeto pasivo.

#¿Cómo se presupuesta?

De forma individual, según el número de plantillas, el volumen de contenido y las integraciones. Recibes un presupuesto por escrito con el alcance y las suposiciones.

#¿Qué recibes al final de la migración?

  • Una auditoría de partida. URL representativas con LCP, INP, CLS y TTFB medidos antes de tocar nada, y la capa responsable del problema identificada. Si muestra que basta con arreglar la caché o las imágenes, te lo digo en lugar de vender una migración.
  • Un frontend bajo control de versiones. Plantillas y componentes de Astro o Next.js en git, publicación mediante compilación y vista previa antes de publicar.
  • La edición en WordPress. Las mismas cuentas, los mismos roles, el mismo flujo de publicación.
  • Formularios, integraciones y redirecciones trasladados, con la lista de URL que hay que comprobar tras el lanzamiento.
  • Un informe de antes y después. Las mismas URL, las mismas condiciones de prueba, ambas fechas de medición y tus datos de campo si los tienes. Sin ese conjunto, un porcentaje es un objetivo.

WordPress, sus plugins, sus cuentas y la API siguen necesitando actualizaciones, control de acceso y copias de seguridad. Una migración del frontend no te quita eso.

#¿Astro o Next.js?

AstroNext.js
Renderizado por defectoTodo el sitio se prerenderiza; export const prerender = false activa el renderizado bajo demanda por rutaEn el App Router, layouts y páginas son Server Components; el renderizado estático o dinámico depende de la ruta
JavaScript en el navegadorNinguno para componentes de Astro; las islas interactivas usan client:load, client:idle o client:visibleReact hidrata los Client Components marcados con "use client"
Contenido que cambiaNueva compilación o rutas bajo demanda; server:defer para server islandsISR con export const revalidate, revalidatePath y revalidateTag
HostingEstático en cualquier servidor; para rutas bajo demanda, adaptador oficial para Cloudflare, Netlify, Node o VercelServidor Node.js o contenedor Docker; con output: 'export' se pierden ISR, Proxy, Server Actions y la optimización de imágenes con el loader por defecto

Astro sirve para blogs, sitios corporativos y documentación. Next.js tiene sentido cuando el frontend es una aplicación con sesiones de usuario, datos por petición o mutaciones desde el servidor. En Next.js 16 el archivo middleware pasó a llamarse proxy; si un tutorial antiguo habla de middleware, es la misma función con otro nombre.

#¿Cómo leo WordPress desde Astro?

La guía oficial de Astro para WordPress usa la REST API integrada en /wp-json/wp/v2/, por ejemplo /wp-json/wp/v2/posts. Las lecturas públicas no necesitan autenticación por defecto. Con _embed llegan también recursos relacionados, como la imagen destacada, y con _fields limitas la respuesta a los campos que usa la plantilla. WPGraphQL es opcional.

En un sitio estático, las rutas dinámicas como /blog/[slug] necesitan getStaticPaths(). Con renderizado bajo demanda no hace falta, pero cada visita consulta la API, así que la caché delante del frontend vuelve a importar.

#¿Y si tu frontend ya está en Next.js?

Algunos proyectos llegan con WordPress headless y un frontend en Next.js que ya no necesita ser una aplicación. La guía oficial de migración de Next.js a Astro describe el camino que sigo:

  • Proyecto nuevo con npm create astro@latest y la integración @astrojs/react para reutilizar componentes React existentes (archivos .jsx o .tsx).
  • Carpetas: public/ se queda igual; el resto pasa a src/, y solo src/pages/ define rutas.
  • Layout: _document o app/layout se sustituyen por un layout de Astro con <html>, <head>, <body> y <slot />.
  • Datos: getStaticProps() se sustituye por await en el frontmatter del componente, con fetch(), getCollection() o getEntry().
  • Sintaxis: <Link> pasa a ser un <a href="">, {children} pasa a ser <slot /> y las props se leen de Astro.props.
  • Imágenes: next/image se sustituye por Image de astro:assets en archivos .astro y .mdx; dentro de componentes React se usa un <img /> normal.

Lo que dependa de ISR o de revalidatePath no tiene un equivalente directo: se resuelve con recompilaciones al publicar o con rutas bajo demanda.

#Cookies y consentimiento al cambiar de frontend

Un frontend nuevo significa un banner de consentimiento nuevo, y es donde más migraciones fallan. El artículo 22.2 de la LSSI-CE exige que el usuario dé su consentimiento, tras recibir información clara y completa, antes de que se guarden o lean datos en su equipo, salvo lo estrictamente necesario para el servicio que ha pedido. La AEPD publica una guía sobre el uso de cookies que sirve de referencia práctica.

En la migración hago inventario de cada script del sitio antiguo (analítica, píxeles, vídeos incrustados, chat) y en el nuevo frontend ninguno se carga antes del consentimiento. En Astro eso suele ser más fácil, porque el HTML no arrastra JavaScript de plugins que nadie revisó.

#¿Cómo es el proceso?

  1. Auditoría. Inventario de URL, plantillas, formularios, integraciones y scripts de terceros, con medición de partida.
  2. Configuración de WordPress como backend. Desactivo lo que solo servía al frontend antiguo, preparo la vista previa y limito el acceso a la API donde haga falta.
  3. Nuevo frontend. Implemento el diseño que tú aportas (archivo de Figma o una plantilla en la que marcas qué elemento va en cada vista). El diseño gráfico y los wireframes no los hago yo.
  4. Pruebas en staging. Redirecciones, metadatos, datos estructurados, formularios, consentimiento y analítica. Cada cambio queda descrito por escrito.
  5. Lanzamiento. Cambio de DNS cuando lo apruebas en staging, comprobación de la lista de URL y revisión en Search Console.

#Escenarios habituales

#Sitio de contenido o blog

Es el caso más claro para Astro. Las entradas cambian poco y se leen mucho, así que prerenderizarlas como HTML elimina las consultas a la base de datos en cada visita. La pregunta práctica es cómo se publica: compilación automática tras cada publicación en WordPress o rutas concretas renderizadas bajo demanda.

#Tienda WooCommerce

El catálogo puede ser estático, pero carrito, pago y cuenta de cliente dependen de sesiones y datos por petición. Antes de proponer un WooCommerce headless reviso qué pasarelas y plugins de envío dependen de las plantillas de WooCommerce. Más detalle en migración de WooCommerce a headless.

#Aplicación con usuarios registrados

Paneles, áreas privadas y formularios con lógica de servidor encajan mejor en Next.js, con Server Components para los datos y Client Components solo donde hay interacción.

#SEO durante la migración

Las URL se conservan o reciben una 301. Títulos, descripciones, canónicas, hreflang, Open Graph, datos estructurados, robots.txt y el sitemap se reconstruyen en el nuevo frontend y se comparan con el sitio antiguo antes del lanzamiento. Después reviso la cobertura en Search Console. Una migración bien hecha evita pérdidas; no promete subidas.

#¿Cómo empezar?

Escríbeme por el formulario de contacto con la URL del sitio, qué te frena hoy y qué integraciones tiene. Te respondo por escrito con las preguntas abiertas y, después de la auditoría, con un presupuesto y sus suposiciones.

Servicios relacionados:

Explora otros servicios WordPress y base de conocimiento

Recomendaciones de LinkedIn

Recomendaciones y opiniones sobre el trabajo con WPPoland

Recomendaciones de personas de las comunidades WordPress, WordCamp y e-commerce. Escriben sobre entrega puntual, profundidad técnica y un enfoque orientado al negocio en el desarrollo de sitios.

Karolina Czapla

Karolina Czapla

Estratega de Marketing, Performance & Digital Strategy

“Trabajar con Mariusz en el WordCamp me ha mostrado lo poco común que es combinar competencias técnicas profundas con un verdadero liderazgo. Planifica, coordina y entrega con precisión, a la vez que da al equipo espacio para crecer y aportar. Cuando otros dicen 'no se puede', él encuentra una solución sin hacer ruido.”

Co‑organizadora, WordCamp Gdynia 2024 y 2025

Anna Kamińska

Anna Kamińska

Talent Acquisition Specialist / HR People Partner

“El portafolio de Mariusz habla por sí solo: refleja su precisión, versatilidad y sentido de la responsabilidad. Se puede confiar en él para conducir un proyecto desde la idea hasta la entrega, mantener informados a los stakeholders y asegurar que todo se haga correctamente y a tiempo.”

Trabajamos en el mismo equipo

Sarah‑Luisa Kwolek

Sarah‑Luisa Kwolek

Gestora de Proyectos TI & Product Owner, Web/App

“Durante más de dos años pude contar siempre con Mariusz para tareas de WordPress, desde el styling y los templates hasta integraciones con terceros. Aporta estabilidad al equipo y mantiene la parte de frontend bajo control.”

Mariusz fue su cliente en proyectos WordPress

Argert Boja

Argert Boja

Senior Full‑Stack Developer

“Mariusz es el compañero de equipo que todos esperan tener: competencias técnicas profundas full‑stack en WordPress, explicaciones claras y una actitud positiva incluso bajo presión. Se mueve con soltura entre plugins personalizados, optimización de rendimiento y layouts de Gutenberg, sin perder de vista la visión de conjunto.”

Trabajamos juntos en proyectos WordPress

Varun Patil

Varun Patil

Líder de Growth & CRM

“Más allá del desarrollo, Mariusz entiende SEO, analítica y growth. Habla directamente con los stakeholders, hace las preguntas correctas y entrega soluciones que mueven los indicadores de negocio: de AMP a tracking y rendimiento.”

Fue responsable de Mariusz en iniciativas de growth

Rafał Osiński

Rafał Osiński

Founder @ EasyTrips.pl, Senior WordPress Dev

“Conozco a Mariusz a través de la comunidad WordPress desde hace muchos años. Es fiable, muy implicado y siempre está presente: en meetups, WordCamps y en los proyectos. Si le importa la colaboración a largo plazo y alguien que trate su sitio como si fuera suyo, él es la persona indicada.”

Co‑organizador de la comunidad WordUp Trójmiasto y WordCamp

Daniel Blossfeld

Daniel Blossfeld

Consultor de Optimización de Procesos y Digitalización

“Tuve el placer de trabajar con Mariusz durante casi tres años. En ese tiempo, sus competencias técnicas profundas en desarrollo WordPress resultaron de un valor incalculable en una variedad de proyectos, desde la construcción de sitios web hasta áreas de socios online e incluso integraciones con Shopify. Es un desarrollador fiable y capaz.”

Mariusz fue su cliente en proyectos WordPress

Natalie Wiszczor

Natalie Wiszczor

Gestora de CRM y E-mail Marketing

“Tuve el gran placer de trabajar con Mariusz durante más de 4 años en el ámbito técnico. Durante ese tiempo demostró ser un compañero competente y fiable. Destacaron especialmente su carácter amable y su notable perseverancia para resolver retos técnicos complejos. Incluso en situaciones de estrés siempre mantuvo la cabeza fría y contribuyó significativamente a un ambiente de trabajo positivo y productivo con su actitud optimista. 🙏🏻🚀”

Trabajó con Mariusz en distintos equipos

Mark Chalklen

Mark Chalklen

Head of Design & Build en Itineris Limited

“Mariusz es un gran miembro del equipo, siempre dispuesto a meterse de lleno en cualquier tarea y a aprender cosas nuevas. Un excelente comunicador y, en general, una persona muy agradable con la que trabajar. ¡Eso sí, es difícil ganarle en nuestra clasificación semanal de Strava!”

Gestionó a Mariusz directamente

Jessica Di Pasquale

Jessica Di Pasquale

Liderando iniciativas de SEO con estrategias de crecimiento basadas en datos.

“Mariusz es una persona muy hábil, paciente y experta. Siempre dispuesto a ayudar y corregir errores, valoré mucho trabajar con él. ¡Es un compañero estupendo!”

Gestionó a Mariusz directamente

Biki John

Biki John

Apasionado del Marketing de Contenidos y entusiasta del SEO

“Fue genial trabajar con Mariusz. Valoré mucho su amplio conocimiento de WordPress y lo útil que resultó siempre que necesité ayuda para moverme por el CMS. Elogio totalmente a Mariusz por su paciencia, su buen carácter y su dominio del oficio; todos lo echaremos mucho de menos.”

Trabajó con Mariusz en distintos equipos

Rafal Borowiec

Rafal Borowiec

Desarrollador de Software, Consultor, Manager y Profesor

“Tuve la oportunidad de trabajar con Mariusz durante 7 meses. Destaca en optimización técnica para motores de búsqueda (SEO). Mariusz cuenta también con una sólida experiencia en desarrollo AMP, GTM y GA. Se siente muy cómodo con WordPress: trabajó en una variedad de proyectos y tareas relacionadas con WordPress, incluyendo desarrollo de landing pages, mejoras de rendimiento y mucho más. Si busca un experto sólido en WordPress especializado en SEO, tracking, rendimiento y desarrollo, no dude en ponerse en contacto con Mariusz.”

Gestionó a Mariusz directamente

Belinda Koch

Belinda Koch

Analista de Web-Tracking en TUI

“Mariusz es una persona estupenda con quien trabajar. Está extremadamente motivado por aprender cosas nuevas y compartir su conocimiento, y domina una amplia gama de temas. Trabajamos juntos en analítica digital y tracking y le estoy muy agradecida por toda la energía, el apoyo y las ideas que aportó a los proyectos.”

Trabajó con Mariusz en temas de analítica digital y tracking

Ali Nezamolmaleki

Ali Nezamolmaleki

Growth, SEO, Pensamiento Analítico, AMP

“Mariusz es una persona extremadamente talentosa en su campo de trabajo. Siempre es capaz de aportar una nueva perspectiva para resolver problemas y de pensar fuera de la caja en situaciones en las que todo parece bloqueado. Trabajar con él es siempre un placer por su personalidad positiva y su actitud de 'se puede hacer'.”

Trabajó con Mariusz en el mismo equipo

Karol Jakubcewicz

Karol Jakubcewicz

Desarrollador Front-end / JavaScript

“Mariusz es un desarrollador WordPress y especialista en SEO/SEM increíblemente experimentado con quien he tenido el placer de trabajar durante casi dos años. Fue una de las figuras clave responsables de la mejora constante del tiempo de carga y del posicionamiento de las páginas. Admiro sus competencias técnicas profundas, vitales para un proyecto WordPress tan complejo, multilingüe y altamente personalizado. Mucha experiencia, una enorme actitud positiva: recomiendo encarecidamente colaborar con Mariusz en cualquier proyecto web.”

Trabajó con Mariusz en el mismo equipo

Paweł Lewczuk

Paweł Lewczuk

Desarrollador Front-end, Desarrollador WordPress

“Colaboré con Mariusz en varios proyectos y nuestra cooperación fue siempre ejemplar. Creo que aún tenemos por delante muchos proyectos conjuntos. ¡Muy recomendable!”

Mariusz fue cliente de Paweł

Przemek Wroblewski

Przemek Wroblewski

Desarrollador de Software con más de 20 años de experiencia

“Encontré en Mariusz a alguien con gran experiencia y un conocimiento profundo de las soluciones frontend. Un desarrollador WordPress sólido, competente y responsable. Tiene facilidad para construir relaciones interpersonales con los demás. Tuvo la visión de ver los beneficios y la pasión para convertirlos en resultados medibles para AirHelp. Sin duda, alguien que querría tener en mi equipo.”

Trabajó con Mariusz en distintos equipos

Todas las recomendaciones en LinkedIn

Preguntas frecuentes

Preguntas sobre alcance, entrega, costes y calidad.

¿Perderé mis posiciones en Google durante la migración a Astro o Next.js?#
Nadie puede garantizar posiciones. Lo que sí controlo: cada URL indexada conserva su dirección o recibe una redirección 301, y títulos, descripciones, canónicas, hreflang y datos estructurados se trasladan al nuevo frontend. Antes del lanzamiento comparo el rastreo del sitio antiguo y del nuevo, y después reviso la cobertura en Google Search Console.
¿Cuánto tiempo tarda una migración de WordPress a Astro?#
Depende del número de plantillas, idiomas, formularios e integraciones. El plazo lo fijo en el presupuesto, después de la auditoría, junto con las suposiciones en las que se basa.
¿Puedo seguir usando WordPress para editar contenido tras migrar a Astro?#
Sí. Tus editores siguen en el panel de WordPress con las mismas cuentas y roles. El frontend en Astro lee el contenido por la REST API de WordPress, que ofrece lecturas públicas sin autenticación por defecto, o por WPGraphQL si lo instalas. En un sitio estático, cada publicación necesita una nueva compilación o una ruta renderizada bajo demanda; eso se decide en el proyecto.
¿Cuáles son los principales beneficios de migrar de WordPress a Astro?#
Astro prerenderiza por defecto y sus componentes llegan al navegador como HTML sin JavaScript de cliente, salvo los que marcas con una directiva client:*. Un WordPress con buena caché también sirve páginas ya generadas, así que primero mido dónde está el problema. Un framework no garantiza una puntuación ni posiciones. WordPress, sus plugins y la API siguen necesitando actualizaciones, control de acceso y copias de seguridad.
¿Qué pasa con mis plugins de WordPress después de la migración?#
Cada plugin se evalúa antes de la migración. Lo que pinta en el frontend (sliders, constructores, formularios) hay que sustituirlo en el nuevo código. La caché de objetos, la seguridad y el mantenimiento de la base de datos siguen importando en el backend. El alcance indica qué se mantiene, qué cambia y qué se elimina.
¿Es mejor Next.js o Astro para mi proyecto?#
Astro encaja con blogs, sitios corporativos y documentación, donde casi todo es contenido. Next.js encaja cuando el frontend es una aplicación: sesiones de usuario, datos por petición, Server Actions o ISR. La guía oficial de Astro advierte que aplicaciones muy interactivas, como paneles de control, pueden requerir técnicas más avanzadas en Astro.
¿Cuánto cuesta una migración de WordPress a Astro?#
Se presupuesta de forma individual según plantillas, volumen de contenido, integraciones e idiomas. Recibes un presupuesto por escrito con el alcance y las suposiciones. Los precios están en la página de precios, no aquí.
¿Ofreces soporte después de completar la migración?#
Sí, como mantenimiento mensual: monitorización de disponibilidad cada 1 a 5 minutos, copias de seguridad con al menos 30 días de retención en países de la UE y actualizaciones probadas primero en staging. No ofrezco guardias 24/7 ni tiempos de respuesta garantizados.