Web editable sin WordPress: Astro y Sveltia CMS para el cliente

Muchas pymes tienen la web en WordPress con un maquetador visual, y el patrón se repite: plugins que actualizar cada semana, una copia de seguridad que nadie comprueba y un cliente que, al cambiar un texto, descuadra sin querer una sección entera. El problema de fondo es que el mismo panel sirve para cambiar el contenido y para tocar el diseño, y por eso busqué una web editable sin WordPress.
Para webs corporativas, de servicios, portfolios o blogs uso desde agosto de 2026 otro montaje: Astro genera la web como ficheros estáticos, Sveltia CMS le da al cliente un panel para editar el contenido, y todo vive en un repositorio Git en un servidor propio. Cada vez que el cliente guarda, la web se vuelve a compilar y se publica sola. Con este montaje funcionan hoy la web de RecchiaDanza, la de Salsa Prat y la de ACAIMA, que hago como voluntario.

Cómo encajan las piezas
El recorrido de un cambio es este:
- El cliente entra en
tudominio.com/adminy edita un texto, una foto o una entrada del blog. - Sveltia guarda ese cambio como un commit en el repositorio Git.
- Git avisa al compilador.
- El compilador ejecuta Astro, que genera HTML, CSS e imágenes.
- La web nueva sustituye a la anterior de golpe, sin estados a medias.
No hay base de datos ni PHP en la web pública. Son ficheros estáticos servidos por un servidor web, así que hay muy poco que atacar y casi nada que actualizar en producción.
Las dos piezas principales tienen licencia MIT. Astro va por la versión 7.4.13 (18 de noviembre de 2026) y en su código la salida por defecto es estática (output: 'static' en packages/astro/src/core/config/schemas/base.ts). Sveltia CMS va por la 0.270.0: sigue en versión 0.x, aunque publica casi a diario. Ojo con ese detalle si tu política exige un 1.0.
Qué hace Sveltia cuando el cliente pulsa «Guardar»
Analizamos cómo guarda Sveltia, porque es lo que de verdad importa. Es una aplicación de una sola página que corre en el navegador del cliente y habla directamente con la API del servidor Git. No necesita un servidor propio.
- Autenticación: el cliente inicia sesión con OAuth en el servidor Git, con el flujo PKCE hecho en el navegador (
src/lib/services/backends/git/shared/auth.js). - Guardado en Gitea o Forgejo: todos los ficheros del cambio van en una sola llamada
POST /repos/{owner}/{repo}/contents, es decir, en un único commit (src/lib/services/backends/git/gitea/commits.js). Si es GitHub, usa la mutacióncreateCommitOnBranchde su API GraphQL. - Protección contra pisarse: cada fichero modificado viaja con el identificador de la versión que el cliente tenía abierta. Si otra persona lo ha cambiado mientras tanto, el servidor rechaza el commit y no se pierde el trabajo de nadie.
- Mensajes de commit legibles: por defecto, «Update {colección} “{entrada}”». Con el historial de Git sé quién cambió qué y cuándo, y puedo volver atrás.
Además tiene multidioma nativo, que en Cataluña es casi obligatorio. Probamos también Keystatic y lo descartamos: cuando lo evaluamos en agosto, su panel necesitaba servidor y no tenía multidioma propio.
Uso Gitea en un servidor propio en lugar de GitHub. La cuenta del cliente vive ahí, el código no depende de un tercero y no hay límites de compilaciones ni condiciones de uso de una plataforma gratuita que revisar cada año.
El cliente edita el contenido, no el diseño
Esta es la regla que hace que el montaje funcione. Antes de escribir código separo:
- Lo del cliente: textos, imágenes, entradas del blog, servicios, preguntas frecuentes y los campos SEO de cada página (título y descripción).
- Lo mío: maquetación, componentes, orden de las secciones, colores y tipografías.
En la práctica, ningún texto está escrito dentro de un componente. Todo sale de ficheros Markdown o YAML que el panel puede editar, y cada campo tiene una etiqueta en el idioma del cliente («Titular principal de la portada», no hero_heading). El cliente puede reescribir la portada entera, pero no puede mover una sección ni cambiar un color, porque esos controles no existen en su panel.
Cada colección de contenido se declara en dos sitios: en el esquema de Astro (src/content.config.ts, con validación Zod) y en la configuración del panel (public/admin/config.yml). Si un campo está en el panel pero no en el esquema, Astro lo descarta al compilar. Lo comprobamos en ACAIMA al añadir un enlace nuevo al pie: había que declararlo también en el esquema o no llegaba a la web.
También limpio la pantalla de acceso. De fábrica, Sveltia muestra su logo, un botón de «iniciar sesión con Gitea» y otro de «token de acceso». Al cliente le dejo el nombre del panel y un botón que dice «Iniciar sesión».
Trampas que me encontré en producción
- Multidioma en ficheros fijos. En una colección de ficheros con todos los idiomas dentro,
i18n: truetiene que ir en la colección y en cada fichero. Si falta, el panel muestra los campos vacíos y, si el cliente guarda, borra el contenido. Por eso abro cada pantalla del panel antes de entregar. - CORS en el servidor Git. El panel llama a la API de Git desde el dominio de la web. Si ese dominio no está autorizado en la configuración CORS, el cliente edita, pulsa «Guardar» y no se guarda, con un error que no menciona CORS. Además hay que poner el origen completo: el dominio a secas no coincide. Me pasó en dos webs.
- Fechas en UTC. Sveltia guarda las fechas en hora universal. En el panel de eventos de Salsa Prat, un social a las 00:30 salía en la web el día anterior hasta que fijé la zona
Europe/Madridal mostrarlas. - Ficheros generados. En RecchiaDanza, la configuración del panel se genera a partir de otros ficheros. Editarla a mano funciona hasta la siguiente generación, que lo pisa todo.
- Imágenes pesadas. Las fotos que el cliente sube desde el panel entran en el repositorio tal cual. Si van a subir muchas, hay que reducirlas o guardarlas fuera.
- Volver atrás lo hago yo. No hay botón de deshacer para el cliente: la marcha atrás se hace con Git.
Dónde lo uso
RecchiaDanza, escuela de baile de Reus. Pasé su web de WordPress con Elementor a Astro con panel, manteniendo las mismas direcciones y con redirecciones 301 donde cambiaron, para no perder el posicionamiento local. Se publicó en su dominio el 26 de octubre de 2026.
ACAIMA, protectora de gatos de Olesa, como voluntario. La lista de gatos en adopción se edita desde el panel: alta, fotos y estado (disponible, reservado, adoptado). Además, su aplicación de gestión escribe en esos mismos ficheros Markdown a través de la API de Git. Hay dos puertas al mismo contenido, y la web siempre sale del repositorio.
Salsa Prat: un panel para dar de alta los eventos, que se publica en Cloudflare Pages desde el mismo compilador.
Cuándo conviene una web editable sin WordPress
Conviene si:
- Es una web corporativa, de servicios, un portfolio o un blog, en uno o varios idiomas.
- El cliente quiere cambiar textos y fotos sin depender de ti, pero no tocar el diseño.
- Quieres velocidad y poco mantenimiento.
No conviene si:
- Necesitas una tienda con stock, zonas privadas de usuarios o contenido que cambia cada hora. Eso va a una aplicación con servidor o a WooCommerce.
- El cliente quiere maquetar cada página: eso pide un constructor visual.
- Nadie va a mantener el servidor Git y el compilador. En ese caso, mejor un hosting gestionado.
Si quieres que lo miremos para tu empresa, escríbeme desde la web. Es como trabajo hoy el desarrollo web a medida cuando el contenido lo lleva el cliente.
Fuentes
Preguntas frecuentes
¿Puede el cliente romper el diseño de la web desde Sveltia CMS?
No, porque su panel solo tiene campos de contenido: textos, imágenes, entradas del blog, servicios, preguntas frecuentes y campos SEO. La maquetación, el orden de las secciones, los colores y las tipografías no tienen controles en su panel.
¿Hace falta base de datos o PHP?
No. Astro genera la web como ficheros estáticos y Sveltia guarda cada cambio como un commit en el repositorio Git, que dispara una nueva compilación y la publicación.
¿Cuándo no conviene este montaje?
Cuando necesitas una tienda con stock, zonas privadas de usuarios o contenido que cambia cada hora, cuando el cliente quiere maquetar él mismo cada página o cuando nadie va a mantener el servidor Git y el compilador.
Sobre cómo escribo estos artículos: preparo los contenidos con ayuda de herramientas de inteligencia artificial y después los reviso, corrijo y publico yo. La responsabilidad editorial de lo que leas aquí es mía.
¿Tienes un proyecto en mente?
Cuéntame qué necesitas y lo sacamos adelante. Respuesta rápida y sin compromiso.
Hablemos →