Habilidad Sveltia CMS
Habilidad completa para integrar Sveltia CMS en proyectos de sitios estáticos.
¿Qué es Sveltia CMS?
Sveltia CMS es un sistema de gestión de contenidos ligero, basado en Git, construido desde cero como el sucesor moderno de Decap CMS (anteriormente Netlify CMS). Proporciona una interfaz de edición rápida e intuitiva para contenido almacenado en repositorios Git.
Características clave
-
Ligero y rápido
- Tamaño del bundle: <500 KB (minificado/brotli) frente a 1.5-2.6 MB de la competencia
- Construido con el compilador Svelte (sin sobrecarga de DOM virtual)
- Utiliza APIs GraphQL para la obtención instantánea de contenido
- Búsqueda basada en relevancia en todo el contenido
-
Experiencia de usuario moderna
- Interfaz de administración intuitiva con uso completo del viewport
- Soporte de modo oscuro (sigue las preferencias del sistema)
- Optimizado para móviles y tabletas
- Carga de archivos por arrastrar y soltar con soporte de múltiples archivos
- Vista previa en tiempo real con actualizaciones instantáneas
-
Arquitectura nativa Git
- Contenido almacenado como Markdown, MDX, YAML, TOML o JSON
- Control de versiones completo e historial de cambios
- Sin dependencia del proveedor: el contenido vive con el código
- Soporta backends de GitHub, GitLab, Gitea, Forgejo
-
Independiente del framework
- Servido como bundle de JavaScript vanilla
- Funciona con Hugo, Jekyll, 11ty, Gatsby, Astro, Next.js, SvelteKit
- Sin dependencias de runtime de React, Vue o frameworks
- Compatible con cualquier generador de sitios estáticos
-
Internacionalización de primera clase
- Soporte integrado de múltiples idiomas
- Integración de traducción DeepL con un clic
- Cambio de idioma durante la edición
- Estructuras i18n flexibles (archivos, carpetas, archivo único)
-
Optimización de imágenes incorporada
- Conversión automática a WebP
- Redimensionamiento y optimización del lado del cliente
- Soporte de optimización SVG
- Calidad y dimensiones configurables
Versiones actuales
- @sveltia/cms: 0.113.5 (octubre de 2025)
- Estado: Beta pública (v1.0 esperada a principios de 2026)
- Madurez: Listo para producción (265+ problemas resueltos del predecesor)
Cuándo usar esta habilidad
✅ Usa Sveltia CMS cuando:
-
Construir sitios estáticos
- Blogs y documentación con Hugo
- Sitios Jekyll y GitHub Pages
- Proyectos 11ty (Eleventy)
- Sitios de marketing con Gatsby
- Sitios con mucho contenido en Astro
-
Los editores no técnicos necesitan acceso
- Equipos de marketing gestionando páginas
- Autores escribiendo entradas de blog
- Equipos de contenido sin conocimiento de Git
- Clientes que necesitan actualizaciones de contenido fáciles
-
Flujo de trabajo basado en Git deseado
- Versionado de contenido mediante Git
- Revisión de contenido a través de pull requests
- El contenido vive con el código en el repositorio
- Integración CI/CD para despliegues
-
Se requiere una solución ligera
- Proyectos sensibles al rendimiento
- Edición móvil prioritaria
- Tiempos de carga rápidos críticos
- Tamaño de bundle mínimo importante
-
Migrar desde Decap/Netlify CMS
- El config.yml existente se puede reutilizar
- Reemplazo directo (cambiar 1 línea)
- Mejor rendimiento y UX
- Mantenimiento activo y corrección de errores
❌ No uses Sveltia CMS cuando:
-
Se necesita colaboración en tiempo real
- Varios usuarios editando simultáneamente (estilo Google Docs)
- Usa Sanity, Contentful o TinaCMS en su lugar
-
Se requiere construcción visual de páginas
- Se necesitan constructores de páginas de arrastrar y soltar
- Usa Webflow, Builder.io o TinaCMS (React) en su lugar
-
Datos altamente dinámicos
- Comercio electrónico con inventario en tiempo real
- Paneles de control o análisis en tiempo real
- Usa bases de datos tradicionales (D1, PostgreSQL) en su lugar
-
Se necesita edición visual específica de React
- Edición de componentes en contexto
- Usa TinaCMS en su lugar (enfocado en React)
Sveltia CMS vs TinaCMS
Usa Sveltia para:
- Hugo, Jekyll, 11ty, Gatsby (SSG no React)
- Experiencia de panel de administración CMS tradicional
- Requisitos de bundle ligero
- Proyectos independientes del framework
Usa TinaCMS para:
- React, Next.js, Astro (componentes React)
- Edición visual en contexto
- Contenido tipado seguro dirigido por esquema
- Experiencia de desarrollo moderna con TypeScript
Ambos son válidos: Sveltia complementa a TinaCMS para diferentes casos de uso.
Patrones de configuración por framework
Usa el patrón de configuración apropiado según tu elección de framework.
1. Configuración Hugo (la más común)
Hugo es el generador de sitios estáticos más popular para Sveltia CMS.
Pasos:
-
Crear directorio admin:
mkdir -p static/admin -
Crear página de índice de admin:
<!-- static/admin/index.html --> <!doctype html> <html lang="en"> <head> <meta charset="utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <title>Content Manager</title> </head> <body> <script src="https://unpkg.com/@sveltia/cms/dist/sveltia-cms.js" type="module"></script> </body> </html> -
Crear archivo de configuración:
# static/admin/config.yml backend: name: github repo: owner/repo branch: main media_folder: static/images/uploads public_folder: /images/uploads collections: - name: posts label: Blog Posts folder: content/posts create: true slug: '{{year}}-{{month}}-{{day}}-{{slug}}' fields: - { label: 'Title', name: 'title', widget: 'string' } - { label: 'Date', name: 'date', widget: 'datetime' } - { label: 'Draft', name: 'draft', widget: 'boolean', default: true } - { label: 'Tags', name: 'tags', widget: 'list', required: false } - { label: 'Body', name: 'body', widget: 'markdown' } -
Iniciar servidor de desarrollo Hugo:
hugo server -
Acceder al admin:
http://localhost:1313/admin/
Plantilla: Ver templates/hugo/
2. Configuración Jekyll
Jekyll se usa comúnmente con GitHub Pages y Sveltia CMS.
Pasos:
-
Crear directorio admin:
mkdir -p admin -
Crear página de índice de admin:
<!-- admin/index.html --> <!doctype html> <html lang="en"> <head> <meta charset="utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <title>Content Manager</title> </head> <body> <script src="https://unpkg.com/@sveltia/cms/dist/sveltia-cms.js" type="module"></script> </body> </html> -
Crear archivo de configuración:
# admin/config.yml backend: name: github repo: owner/repo branch: main media_folder: assets/images/uploads public_folder: /assets/images/uploads collections: - name: posts label: Blog Posts folder: _posts create: true slug: '{{year}}-{{month}}-{{day}}-{{slug}}' fields: - { label: 'Layout', name: 'layout', widget: 'hidden', default: 'post' } - { label: 'Title', name: 'title', widget: 'string' } - { label: 'Date', name: 'date', widget: 'datetime' } - { label: 'Categories', name: 'categories', widget: 'list', required: false } - { label: 'Body', name: 'body', widget: 'markdown' } -
Iniciar servidor de desarrollo Jekyll:
bundle exec jekyll serve -
Acceder al admin:
http://localhost:4000/admin/
Plantilla: Ver templates/jekyll/
3. Configuración 11ty (Eleventy)
11ty funciona bien con Sveltia CMS para sitios estáticos flexibles.
Pasos:
-
Crear directorio admin:
mkdir -p admin -
Crear página de índice de admin:
<!-- admin/index.html --> <!doctype html> <html lang="en"> <head> <meta charset="utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <title>Content Manager</title> </head> <body> <script src="https://unpkg.com/@sveltia/cms/dist/sveltia-cms.js" type="module"></script> </body> </html> -
Crear archivo de configuración:
# admin/config.yml backend: name: github repo: owner/repo branch: main media_folder: src/assets/images public_folder: /assets/images collections: - name: blog label: Blog Posts folder: src/posts create: true slug: '{{slug}}' fields: - { label: 'Title', name: 'title', widget: 'string' } - { label: 'Description', name: 'description', widget: 'text' } - { label: 'Date', name: 'date', widget: 'datetime' } - { label: 'Tags', name: 'tags', widget: 'list', required: false } - { label: 'Body', name: 'body', widget: 'markdown' } -
Añadir copia de paso a
.eleventy.js:module.exports = function(eleventyConfig) { eleventyConfig.addPassthroughCopy('admin'); // ... resto de la configuración }; -
Iniciar servidor de desarrollo 11ty:
npx @11ty/eleventy --serve -
Acceder al admin:
http://localhost:8080/admin/
Plantilla: Ver templates/11ty/
4. Configuración Astro
Astro es un framework moderno que funciona bien con Sveltia CMS.
Pasos:
-
Crear directorio admin:
mkdir -p public/admin -
Crear página de índice de admin:
<!-- public/admin/index.html --> <!doctype html> <html lang="en"> <head> <meta charset="utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <title>Content Manager</title> </head> <body> <script src="https://unpkg.com/@sveltia/cms/dist/sveltia-cms.js" type="module"></script> </body> </html> -
Crear archivo de configuración:
# public/admin/config.yml backend: name: github repo: owner/repo branch: main media_folder: public/images public_folder: /images collections: - name: blog label: Blog Posts folder: src/content/blog create: true slug: '{{slug}}' format: mdx fields: - { label: 'Title', name: 'title', widget: 'string' } - { label: 'Description', name: 'description', widget: 'text' } - { label: 'Published Date', name: 'pubDate', widget: 'datetime' } - { label: 'Hero Image', name: 'heroImage', widget: 'image', required: false } - { label: 'Body', name: 'body', widget: 'markdown' } -
Iniciar servidor de desarrollo Astro:
npm run dev -
Acceder al admin:
http://localhost:4321/admin/
Plantilla: Ver templates/astro/
5. Configuración independiente del framework
Aplica a: Gatsby, Next.js (modo SSG), SvelteKit, Remix, o cualquier framework
Pasos:
-
Determinar directorio público:
- Gatsby:
static/ - Next.js:
public/ - SvelteKit:
static/ - Remix:
public/
- Gatsby:
-
Crear directorio admin en la carpeta pública:
mkdir -p <carpeta-publica>/admin -
Crear página de índice de admin:
<!doctype html> <html lang="en"> <head> <meta charset="utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <title>Content Manager</title> </head> <body> <script src="https://unpkg.com/@sveltia/cms/dist/sveltia-cms.js" type="module"></script> </body> </html> -
Crear archivo de configuración adaptado a tu estructura de contenido:
backend: name: github repo: owner/repo branch: main media_folder: <tu-ruta-de-medios> public_folder: <tu-ruta-pública> collections: # Define según tu estructura de contenido -
Acceder al admin:
http://localhost:<puerto>/admin/
Configuración de autenticación
Elige el método de autenticación que se adapte a tu plataforma de despliegue.
Opción 1: Cloudflare Workers OAuth (Recomendado) 🔥
Mejor para: Cloudflare Pages, Cloudflare Workers, cualquier despliegue
Esto utiliza el Worker oficial sveltia-cms-auth de Cloudflare para OAuth.
Pasos:
-
Desplegar Worker:
# Clonar el worker de autenticación git clone https://github.com/sveltia/sveltia-cms-auth cd sveltia-cms-auth # Instalar dependencias npm install # Desplegar en Cloudflare Workers npx wrangler deployO usar despliegue con un clic:
- Visita https://github.com/sveltia/sveltia-cms-auth
- Haz clic en el botón "Deploy to Cloudflare Workers"
-
Registrar aplicación OAuth en GitHub:
- Ve a https://github.com/settings/developers
- Haz clic en "New OAuth App"
- Application name: CMS de tu sitio
- Homepage URL: https://tudominio.com
- Authorization callback URL: https://tu-worker.workers.dev/callback
- Guarda el Client ID y Client Secret
-
Configurar variables de entorno del Worker:
# Configurar credenciales de GitHub npx wrangler secret put GITHUB_CLIENT_ID # Pega tu Client ID npx wrangler secret put GITHUB_CLIENT_SECRET # Pega tu Client Secret # Opcional: Restringir a dominios específicos npx wrangler secret put ALLOWED_DOMAINS # Ejemplo: tudominio.com,*.tudominio.com -
Actualizar configuración del CMS:
# admin/config.yml backend: name: github repo: owner/repo branch: main base_url: https://tu-worker.workers.dev # ← Añadir esta línea -
Probar autenticación:
- Abre el
/admin/de tu sitio - Haz clic en "Login with GitHub"
- Autoriza la aplicación
- Deberías ser redirigido de vuelta al CMS
- Abre el
Guía completa: Ver references/cloudflare-auth-setup.md
Plantilla: Ver templates/cloudflare-workers/
Opción 2: Vercel Serverless Functions
Mejor para: Despliegues en Vercel
Pasos:
-
Crear ruta API:
// api/auth.ts export default async function handler(req, res) { // Lógica de manejo de OAuth // Ver templates/vercel-serverless/api-auth.ts } -
Configurar variables de entorno en Vercel:
GITHUB_CLIENT_ID=tu_client_id GITHUB_CLIENT_SECRET=tu_client_secret -
Actualizar configuración del CMS:
backend: name: github repo: owner/repo branch: main base_url: https://tudominio.com/api/auth