Communitygithub.com

ovachiever/droid-tings

Configura Sveltia CMS, el liviano CMS basado en Git sucesor de Decap/Netlify CMS, con un bundle 5 veces más pequeño (300 KB), rendimiento GraphQL y más de 260 problemas resueltos de su predecesor. Independiente del framework para Hugo, Jekyll, 11ty, Gatsby, Astro.

¿Qué es droid-tings?

Esta habilidad permite integrar Sveltia CMS en proyectos de sitios estáticos de manera completa y eficiente. Sveltia CMS es un sistema de gestión de contenidos liviano y moderno, construido desde cero como sucesor de Decap CMS, que ofrece un bundle de menos de 500 KB, APIs GraphQL para obtener contenido de forma instantánea y una interfaz de edición intuitiva con soporte de modo oscuro y arrastrar y soltar. Soporta múltiples backends Git como GitHub, GitLab, Gitea y Forgejo, y es compatible con frameworks populares como Hugo, Jekyll, 11ty, Gatsby, Astro, Next.js y SvelteKit, sin dependencias de runtime de frameworks. Además, incluye características como internacionalización con traducción DeepL, optimización de imágenes integrada, y autenticación mediante Cloudflare Workers (recomendado) o funciones serverless de Vercel. Es ideal para migrar desde Decap CMS, ya que la configuración existente (config.yml) se puede reutilizar, y ofrece un rendimiento superior y mantenimiento activo con más de 265 problemas resueltos de su predecesor.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ovachiever/droid-tings/tree/HEAD/skills/sveltia-cms

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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

  1. 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
  2. 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
  3. 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
  4. 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
  5. 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)
  6. 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:

  1. 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
  2. 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
  3. 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
  4. 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
  5. 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:

  1. Se necesita colaboración en tiempo real

    • Varios usuarios editando simultáneamente (estilo Google Docs)
    • Usa Sanity, Contentful o TinaCMS en su lugar
  2. 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
  3. 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
  4. 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:

  1. Crear directorio admin:

    mkdir -p static/admin
    
  2. 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>
    
  3. 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' }
    
  4. Iniciar servidor de desarrollo Hugo:

    hugo server
    
  5. 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:

  1. Crear directorio admin:

    mkdir -p admin
    
  2. 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>
    
  3. 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' }
    
  4. Iniciar servidor de desarrollo Jekyll:

    bundle exec jekyll serve
    
  5. 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:

  1. Crear directorio admin:

    mkdir -p admin
    
  2. 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>
    
  3. 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' }
    
  4. Añadir copia de paso a .eleventy.js:

    module.exports = function(eleventyConfig) {
      eleventyConfig.addPassthroughCopy('admin');
      // ... resto de la configuración
    };
    
  5. Iniciar servidor de desarrollo 11ty:

    npx @11ty/eleventy --serve
    
  6. 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:

  1. Crear directorio admin:

    mkdir -p public/admin
    
  2. 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>
    
  3. 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' }
    
  4. Iniciar servidor de desarrollo Astro:

    npm run dev
    
  5. 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:

  1. Determinar directorio público:

    • Gatsby: static/
    • Next.js: public/
    • SvelteKit: static/
    • Remix: public/
  2. Crear directorio admin en la carpeta pública:

    mkdir -p <carpeta-publica>/admin
    
  3. 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>
    
  4. 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
    
  5. 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:

  1. 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 deploy
    

    O usar despliegue con un clic:

  2. Registrar aplicación OAuth en GitHub:

  3. 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
    
  4. 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
    
  5. 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

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:

  1. 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
    }
    
  2. Configurar variables de entorno en Vercel:

    GITHUB_CLIENT_ID=tu_client_id
    GITHUB_CLIENT_SECRET=tu_client_secret
    
  3. Actualizar configuración del CMS:

    backend:
      name: github
      repo: owner/repo
      branch: main
      base_url: https://tudominio.com/api/auth
    

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Skills relacionados