Notas de campo · Diseño web

Wix headless con Astro: lo que aprendí al reconstruir cuatro sitios

Cuatro sitios salieron de Wix Editor y pasaron a Wix headless con Astro. Lo que medí, lo que se rompió sin que ninguna documentación lo advirtiera y cómo saber si a tu sitio le conviene dar el mismo paso.

En los últimos dos meses saqué cuatro sitios de Wix Editor: dos de D'Argenta (dargentaawards.com y dargentaenterprise.com), la tienda de Donna Roffe (donnaroffe.com) y este sitio. Wix sigue manejando todo lo que está detrás de las páginas: citas, formularios, imágenes, el catálogo de la tienda y el dominio. Las páginas ahora son Astro, generadas en el servidor.

Por qué salir del Editor: los números

Una página de Wix Editor carga con todo el motor de Wix. Antes de la reconstrucción, cada página de este sitio pesaba entre 0.8 y 1.0 MB solo de HTML y cargaba entre 195 y 255 archivos. Los sitios de D'Argenta estaban en el mismo rango: alrededor de 1 MB de HTML por página en Awards, y entre 541 y 972 KB en la página de Enterprise que medí.

Después de la reconstrucción, las páginas de inicio miden:

simonabrahamworks.com
HTML (comprimido)
14.5 KB
Solicitudes (móvil)
23
Lighthouse móvil
91
Lighthouse escritorio
98
dargentaawards.com
HTML (comprimido)
20 KB
Solicitudes (móvil)
29
Lighthouse móvil
83
Lighthouse escritorio
95
dargentaenterprise.com
HTML (comprimido)
22 KB
Solicitudes (móvil)
28
Lighthouse móvil
80
Lighthouse escritorio
96
donnaroffe.com
HTML (comprimido)
13.5 KB
Solicitudes (móvil)
35
Lighthouse móvil
82
Lighthouse escritorio
98

Mediciones de la página de inicio después de la reconstrucción
Sitio	HTML (comprimido)	Solicitudes (móvil)	Lighthouse móvil	Lighthouse escritorio
simonabrahamworks.com	14.5 KB	23	91	98
dargentaawards.com	20 KB	29	83	95
dargentaenterprise.com	22 KB	28	80	96
donnaroffe.com	13.5 KB	35	82	98

Lighthouse 12, página de inicio, mediana de tres mediciones por sitio y dispositivo, 7 de octubre de 2026. Las cifras de laboratorio varían unos puntos entre mediciones; la diferencia de abajo, no.

Para comparar, una tienda en Wix Editor con la que trabajo, medida el mismo día con la misma herramienta: 2.9 MB de HTML (411 KB comprimido), 396 solicitudes en móvil, Lighthouse 32 en móvil y 42 en escritorio.

Accesibilidad, buenas prácticas y SEO obtuvieron entre 96 y 100 en los cuatro sitios reconstruidos.

La velocidad es lo que se ve. El cambio más grande es el control: cada título, descripción, encabezado, tamaño de imagen y línea de datos estructurados ahora lo escribo yo, no lo decide el Editor.

La configuración

Wix headless administrado significa que Wix aloja el sitio de Astro, se encarga del inicio de sesión y las variables de entorno, y le da al código acceso directo a las mismas apps de negocio que usaba el Editor.

Lo que funcionó

Vincula tu propio proyecto: Parte de tu propio proyecto de Astro y corre npm create @wix/new@latest -- headless link. Crea un negocio y un sitio nuevos en Wix para el proyecto.
Quédate en Astro 5: La integración de Wix todavía no es compatible con Astro 6.
Genera en el servidor: Usa el adaptador de hosting de Wix con salida de servidor, para que cada página se genere al pedirla y muestre siempre datos actuales.
Deja el negocio en Wix: Las citas, la bandeja de mensajes, las imágenes y el catálogo se quedan en el panel de Wix. El sitio los lee y escribe con las APIs de Wix, así que una cita hecha en el sitio nuevo llega al calendario de Wix Bookings como cualquier otra.
Publica con un comando: Cada proyecto tiene un script que corre las revisiones, hace commit en GitHub, compila y publica. Nada sale en vivo si no está en control de versiones.

Algo cambió durante el proyecto: la versión 1.1.254 del CLI de Wix agregó el comando finalize-migration, el último paso para pasar un sitio existente de Editor a un frontend headless en el mismo sitio de Wix, en lugar de uno nuevo. Hasta entonces, todo proyecto headless empezaba como un sitio nuevo. Wix todavía no lo documenta; lo escribiré cuando lo haya corrido de principio a fin.

Lo que se rompe en producción

Nada de esto aparece en tu computadora. Todo apareció en un dominio en vivo.

Cinco trampas

Wix responde primero algunos archivos: robots.txt, llms.txt, sitemap.xml y favicon.ico los sirve el edge de Wix, no tu código, así que una ruta de Astro para ellos no hace nada. Configura robots.txt y llms.txt en los ajustes de SEO de Wix o con sus APIs, y enlaza tus íconos desde el head de la página: el /favicon.ico de Wix se queda en blanco subas lo que subas.
El sitio cree que está en http: Wix termina la conexión HTTPS antes de que la solicitud llegue a Astro, así que Astro.url dice http://. Cada canonical, enlace hreflang e imagen para compartir construidos con eso salían mal. Fija el origen de producción en un solo lugar y arma cada URL absoluta a partir de él.
Wix agrega sus propias etiquetas SEO: Wix inyecta un segundo título, descripción, canonical y sus propios datos estructurados de la página de inicio encima de los tuyos. Dos canonicals son peor que ninguno, así que un pequeño paso de middleware quita las copias de Wix.
Ignora los encabezados de caché: Puse s-maxage para que el edge guardara el HTML en caché. Nunca lo hizo. El servidor respondía en 0.3–0.6 s sin eso, así que quité el código en lugar de dejar algo que solo parecía funcionar.
Tu sitemap no es el de Wix: Wix se queda con /sitemap.xml. Publica tu propio índice en otra ruta, como /sitemap-index.xml, apunta robots.txt hacia él y envía ese a Google y a Bing.

SEO hecho a propósito

Tres de los cuatro sitios en Editor tenían el mismo defecto: el texto estaba traducido a cada idioma, pero el título y la meta descripción no. La página de inicio de Awards tenía un solo título en 23 idiomas; la de Enterprise, uno solo en 99. La tienda de Donna Roffe tenía otro problema: 18 páginas compartían 6 títulos, y Google tenía indexada exactamente una de sus páginas.

Lo que ahora hace cada sitio

Un H1, títulos únicos: Un H1 por página, y un título y una descripción únicos en cada idioma.
Un solo grafo conectado: Datos estructurados como un solo grafo enlazado — Person u Organization, WebSite, WebPage, migas de pan, y Product o Service donde aplican — en lugar de fragmentos sueltos.
Idiomas en el sitemap: hreflang vive solo en los sitemaps XML, no repetido en el head de cada página, así hay una sola fuente de verdad que mantener.
301 para cada URL vieja: Rutas del Editor como /contact-8 y /copy-of-website-design pasan a rutas limpias, y no se pierde nada que ya posicionaba.
IndexNow en cada publicación: Después de cada publicación, el sitio manda su lista completa de URLs a Bing y a los demás buscadores de IndexNow, que detectan los cambios en minutos y no en semanas.
Un llms.txt: Un resumen en texto plano de a quién pertenece el sitio y qué responde cada página, para los asistentes de IA que lo leen.

Más de un idioma, incluido uno de derecha a izquierda

Este sitio está en inglés, español de México y hebreo. Awards está en 23 idiomas y Enterprise en 98.

Lo que hace falta

Una URL por idioma: Cada idioma tiene su propia URL (/es/…, /he/…), su propio título y descripción, y su propia entrada en el sitemap.
Derecha a izquierda de verdad: Las páginas en hebreo declaran dir="rtl" en el documento, y el diseño sigue la dirección de lectura en lugar de parcharse después.
Cuidado con la dirección mixta: Una abreviatura latina entre paréntesis dentro de una frase en hebreo puede reordenarse hasta no tener sentido. Prueba cada texto en hebreo en un navegador, no en el editor.
México, no España: El sitio anterior declaraba es-ES; el público es mexicano, así que es es-MX.

¿Le conviene a tu sitio?

Conviene cuando: El sitio genera ventas o contactos desde los buscadores y los límites de velocidad o SEO del Editor te están costando; necesitas más de un idioma bien hecho; o quieres el sitio en control de versiones, con cada cambio revisado y reversible.
No conviene cuando: Cambias el diseño tú mismo cada semana y no quieres a un desarrollador de por medio; el sitio depende de apps exclusivas del Editor o de Wix Members, que no se pueden pasar de un sitio de Wix a otro; o un sitio pequeño de presentación ya carga rápido y aparece cuando buscan tu nombre.

¿Lo estás pensando para tu sitio de Wix?

Agenda una hora y lo revisamos juntos.

Agenda una llamada Lee el caso de D'Argenta