Compétence Sveltia CMS
Compétence complète pour intégrer Sveltia CMS dans des projets de sites statiques.
Qu'est-ce que Sveltia CMS ?
Sveltia CMS est un système de gestion de contenu (CMS) léger, sans tête et basé sur Git, construit de zéro comme successeur moderne de Decap CMS (anciennement Netlify CMS). Il offre une interface d'édition rapide et intuitive pour le contenu stocké dans des dépôts Git.
Fonctionnalités clés
-
Léger et rapide
- Taille du bundle : <500 Ko (minifié/brotli) contre 1,5-2,6 Mo pour les concurrents
- Construit avec le compilateur Svelte (pas de surcharge de DOM virtuel)
- Utilise des API GraphQL pour une récupération instantanée du contenu
- Recherche par pertinence sur tout le contenu
-
Expérience utilisateur moderne
- Interface d'administration intuitive avec utilisation maximale de la fenêtre
- Prise en charge du mode sombre (suit les préférences système)
- Optimisé pour mobile et tablette
- Téléchargement de fichiers par glisser-déposer avec prise en charge de fichiers multiples
- Prévisualisation en temps réel avec mises à jour instantanées
-
Architecture native Git
- Contenu stocké en Markdown, MDX, YAML, TOML ou JSON
- Contrôle de version complet et historique des modifications
- Pas de verrouillage propriétaire - le contenu vit avec le code
- Prise en charge des backends GitHub, GitLab, Gitea, Forgejo
-
Indépendant du framework
- Servi comme un bundle JavaScript vanille
- Fonctionne avec Hugo, Jekyll, 11ty, Gatsby, Astro, Next.js, SvelteKit
- Pas de dépendances d'exécution React, Vue ou autre framework
- Compatible avec tout générateur de site statique
-
Internationalisation de première classe
- Prise en charge de plusieurs langues intégrée
- Intégration de la traduction DeepL en un clic
- Changement de locale pendant l'édition
- Structures i18n flexibles (fichiers, dossiers, fichier unique)
-
Optimisation d'image intégrée
- Conversion automatique en WebP
- Redimensionnement et optimisation côté client
- Prise en charge de l'optimisation SVG
- Qualité et dimensions configurables
Versions actuelles
- @sveltia/cms : 0.113.5 (Octobre 2025)
- Statut : Bêta publique (v1.0 attendue début 2026)
- Maturité : Prêt pour la production (265+ problèmes résolus du prédécesseur)
Quand utiliser cette compétence
✅ Utilisez Sveltia CMS quand :
-
Vous créez des sites statiques
- Blogs Hugo et documentation
- Sites Jekyll et GitHub Pages
- Projets 11ty (Eleventy)
- Sites marketing Gatsby
- Sites riches en contenu Astro
-
Des éditeurs non techniques ont besoin d'accès
- Équipes marketing gérant des pages
- Auteurs écrivant des articles de blog
- Équipes de contenu sans connaissance de Git
- Clients ayant besoin de mises à jour faciles du contenu
-
Un workflow basé sur Git est souhaité
- Versionnement du contenu via Git
- Révision du contenu via les pull requests
- Le contenu vit avec le code dans le dépôt
- Intégration CI/CD pour les déploiements
-
Une solution légère est requise
- Projets sensibles aux performances
- Édition mobile-first nécessaire
- Temps de chargement rapides critiques
- Taille de bundle minimale importante
-
Migration depuis Decap/Netlify CMS
- Le fichier config.yml existant peut être réutilisé
- Remplacement direct (changer 1 ligne)
- Meilleures performances et UX
- Maintenance active et correctifs de bugs
❌ N'utilisez pas Sveltia CMS quand :
-
Collaboration en temps réel nécessaire
- Plusieurs utilisateurs éditant simultanément (style Google Docs)
- Utilisez Sanity, Contentful ou TinaCMS à la place
-
Construction visuelle de pages requise
- Constructeurs de pages par glisser-déposer nécessaires
- Utilisez Webflow, Builder.io ou TinaCMS (React) à la place
-
Données hautement dynamiques
- E-commerce avec inventaire en temps réel
- Tableaux de bord ou analyses en temps réel
- Utilisez des bases de données traditionnelles (D1, PostgreSQL) à la place
-
Édition visuelle spécifique à React nécessaire
- Édition de composants en contexte
- Utilisez TinaCMS à la place (axé React)
Sveltia CMS vs TinaCMS
Utilisez Sveltia pour :
- Hugo, Jekyll, 11ty, Gatsby (SSG non React)
- UX de panneau d'administration CMS traditionnel
- Exigences de bundle léger
- Projets indépendants du framework
Utilisez TinaCMS pour :
- React, Next.js, Astro (composants React)
- Édition visuelle en contexte
- Contenu type-safe piloté par schéma
- Expérience développeur moderne avec TypeScript
Les deux sont valides - Sveltia complète TinaCMS pour différents cas d'utilisation.
Modèles de configuration par framework
Utilisez le modèle de configuration approprié en fonction de votre choix de framework.
1. Configuration Hugo (la plus courante)
Hugo est le générateur de site statique le plus populaire pour Sveltia CMS.
Étapes :
-
Créez le répertoire admin :
mkdir -p static/admin -
Créez la page d'index 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>Gestionnaire de contenu</title> </head> <body> <script src="https://unpkg.com/@sveltia/cms/dist/sveltia-cms.js" type="module"></script> </body> </html> -
Créez le fichier de configuration :
# 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: Articles de blog folder: content/posts create: true slug: '{{year}}-{{month}}-{{day}}-{{slug}}' fields: - { label: 'Titre', name: 'title', widget: 'string' } - { label: 'Date', name: 'date', widget: 'datetime' } - { label: 'Brouillon', name: 'draft', widget: 'boolean', default: true } - { label: 'Tags', name: 'tags', widget: 'list', required: false } - { label: 'Corps', name: 'body', widget: 'markdown' } -
Démarrez le serveur de développement Hugo :
hugo server -
Accédez à l'admin :
http://localhost:1313/admin/
Modèle : Voir templates/hugo/
2. Configuration Jekyll
Jekyll est couramment utilisé avec GitHub Pages et Sveltia CMS.
Étapes :
-
Créez le répertoire admin :
mkdir -p admin -
Créez la page d'index 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>Gestionnaire de contenu</title> </head> <body> <script src="https://unpkg.com/@sveltia/cms/dist/sveltia-cms.js" type="module"></script> </body> </html> -
Créez le fichier de configuration :
# 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: Articles de blog folder: _posts create: true slug: '{{year}}-{{month}}-{{day}}-{{slug}}' fields: - { label: 'Layout', name: 'layout', widget: 'hidden', default: 'post' } - { label: 'Titre', name: 'title', widget: 'string' } - { label: 'Date', name: 'date', widget: 'datetime' } - { label: 'Catégories', name: 'categories', widget: 'list', required: false } - { label: 'Corps', name: 'body', widget: 'markdown' } -
Démarrez le serveur de développement Jekyll :
bundle exec jekyll serve -
Accédez à l'admin :
http://localhost:4000/admin/
Modèle : Voir templates/jekyll/
3. Configuration 11ty (Eleventy)
11ty fonctionne bien avec Sveltia CMS pour des sites statiques flexibles.
Étapes :
-
Créez le répertoire admin :
mkdir -p admin -
Créez la page d'index 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>Gestionnaire de contenu</title> </head> <body> <script src="https://unpkg.com/@sveltia/cms/dist/sveltia-cms.js" type="module"></script> </body> </html> -
Créez le fichier de configuration :
# admin/config.yml backend: name: github repo: owner/repo branch: main media_folder: src/assets/images public_folder: /assets/images collections: - name: blog label: Articles de blog folder: src/posts create: true slug: '{{slug}}' fields: - { label: 'Titre', 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: 'Corps', name: 'body', widget: 'markdown' } -
Ajoutez la copie passthrough à
.eleventy.js:module.exports = function(eleventyConfig) { eleventyConfig.addPassthroughCopy('admin'); // ... reste de la configuration }; -
Démarrez le serveur de développement 11ty :
npx @11ty/eleventy --serve -
Accédez à l'admin :
http://localhost:8080/admin/
Modèle : Voir templates/11ty/
4. Configuration Astro
Astro est un framework moderne qui fonctionne bien avec Sveltia CMS.
Étapes :
-
Créez le répertoire admin :
mkdir -p public/admin -
Créez la page d'index 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>Gestionnaire de contenu</title> </head> <body> <script src="https://unpkg.com/@sveltia/cms/dist/sveltia-cms.js" type="module"></script> </body> </html> -
Créez le fichier de configuration :
# public/admin/config.yml backend: name: github repo: owner/repo branch: main media_folder: public/images public_folder: /images collections: - name: blog label: Articles de blog folder: src/content/blog create: true slug: '{{slug}}' format: mdx fields: - { label: 'Titre', name: 'title', widget: 'string' } - { label: 'Description', name: 'description', widget: 'text' } - { label: 'Date de publication', name: 'pubDate', widget: 'datetime' } - { label: 'Image à la une', name: 'heroImage', widget: 'image', required: false } - { label: 'Corps', name: 'body', widget: 'markdown' } -
Démarrez le serveur de développement Astro :
npm run dev -
Accédez à l'admin :
http://localhost:4321/admin/
Modèle : Voir templates/astro/
5. Configuration indépendante du framework
S'applique à : Gatsby, Next.js (mode SSG), SvelteKit, Remix, ou tout autre framework
Étapes :
-
Déterminez le répertoire public :
- Gatsby :
static/ - Next.js :
public/ - SvelteKit :
static/ - Remix :
public/
- Gatsby :
-
Créez le répertoire admin dans le dossier public :
mkdir -p <dossier-public>/admin -
Créez la page d'index admin :
<!doctype html> <html lang="en"> <head> <meta charset="utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <title>Gestionnaire de contenu</title> </head> <body> <script src="https://unpkg.com/@sveltia/cms/dist/sveltia-cms.js" type="module"></script> </body> </html> -
Créez le fichier de configuration adapté à votre structure de contenu :
backend: name: github repo: owner/repo branch: main media_folder: <votre-chemin-media> public_folder: <votre-chemin-public> collections: # Définissez en fonction de votre structure de contenu -
Accédez à l'admin :
http://localhost:<port>/admin/
Configuration de l'authentification
Choisissez la méthode d'authentification qui correspond à votre plateforme de déploiement.
Option 1 : OAuth Cloudflare Workers (Recommandé) 🔥
Meilleur pour : Cloudflare Pages, Cloudflare Workers, tout déploiement
Cette méthode utilise le Worker Cloudflare officiel sveltia-cms-auth pour l'OAuth.
Étapes :
-
Déployez le Worker :
# Clonez le worker d'authentification git clone https://github.com/sveltia/sveltia-cms-auth cd sveltia-cms-auth # Installez les dépendances npm install # Déployez sur Cloudflare Workers npx wrangler deployOu utilisez le déploiement en un clic :
- Visitez https://github.com/sveltia/sveltia-cms-auth
- Cliquez sur le bouton "Déployer sur Cloudflare Workers"
-
Enregistrez l'application OAuth sur GitHub :
- Allez sur https://github.com/settings/developers
- Cliquez sur "Nouvelle application OAuth"
- Nom de l'application : CMS de votre site
- URL de la page d'accueil : https://votredomaine.com
- URL de callback d'autorisation : https://votre-worker.workers.dev/callback
- Sauvegardez l'ID client et le secret client
-
Configurez les variables d'environnement du Worker :
# Définissez les identifiants GitHub npx wrangler secret put GITHUB_CLIENT_ID # Collez votre ID client npx wrangler secret put GITHUB_CLIENT_SECRET # Collez votre secret client # Facultatif : Restreindre à des domaines spécifiques npx wrangler secret put ALLOWED_DOMAINS # Exemple : votredomaine.com,*.votredomaine.com -
Mettez à jour la configuration CMS :
# admin/config.yml backend: name: github repo: owner/repo branch: main base_url: https://votre-worker.workers.dev # ← Ajoutez cette ligne -
Testez l'authentification :
- Ouvrez
/admin/de votre site - Cliquez sur "Connexion avec GitHub"
- Autorisez l'application
- Vous devriez être redirigé vers le CMS
- Ouvrez
Guide complet : Voir references/cloudflare-auth-setup.md
Modèle : Voir templates/cloudflare-workers/
Option 2 : Fonctions serverless Vercel
Meilleur pour : Déploiements Vercel
Étapes :
-
Créez une route API :
// api/auth.ts export default async function handler(req, res) { // Logique de traitement OAuth // Voir templates/vercel-serverless/api-auth.ts } -
Définissez les variables d'environnement dans Vercel :
GITHUB_CLIENT_ID=your_client_id GITHUB_CLIENT_SECRET=your_client_secret -
Mettez à jour la configuration CMS :
backend: name: github repo: owner/repo branch: main base_url: https://votredomaine.com/api/auth
...
*(Le reste du contenu original a été tronqué dans la demande. La traduction ci-dessus couvre la partie fournie.)*