Prise en main

Comprenez ce qu'est EmDash CMS, sur quelle stack il repose et la meilleure façon de lancer aujourd'hui un site de contenu officiel EmDash.

Qu’est-ce qu’EmDash CMS

EmDash CMS est présenté publiquement comme un CMS TypeScript full-stack construit sur Astro et conçu pour fonctionner particulièrement bien sur Cloudflare. Le produit conserve plusieurs concepts déjà familiers pour les utilisateurs de WordPress, notamment :

  • les collections et types de contenu
  • les taxonomies, menus et widgets
  • une interface d’administration pour les éditeurs
  • un modèle de plugins pour étendre le comportement du site

La différence est qu’EmDash s’appuie sur des outils frontend modernes, du contenu typé et des options de déploiement natives Cloudflare, plutôt que sur un hébergement PHP.

Ce qui le distingue d’un CMS classique

D’après la documentation publique officielle et les ressources du dépôt, plusieurs points reviennent systématiquement :

  • EmDash est natif Astro, pas un SaaS séparé appelé via API
  • il utilise TypeScript sur toute la stack
  • il est conçu pour être portable entre clouds
  • son modèle de plugins repose sur une exécution en sandbox dans les isolates Cloudflare Workers
  • il utilise du contenu structuré plutôt que de tout lier à un stockage HTML de type WordPress

C’est cette combinaison qui le rend pertinent pour un site écosystème public comme emdashcmseverything.com.

Première version recommandée pour ce site

Même si EmDash prend en charge une architecture CMS runtime, la meilleure première version de ce site reste un site de contenu Astro statique.

Pour ce projet, la stack recommandée est :

  • Astro pour le framework du site
  • MDX pour les contenus longs et les pages de ressources
  • Cloudflare Pages pour un hébergement à faible coût
  • Git + édition assistée par IA pour la publication continue

C’est le bon point de départ parce que votre site sert principalement à :

  • la documentation
  • la FAQ et les guides de migration
  • les pages d’annuaire de plugins et de templates
  • les mises à jour, tutoriels et contenus pédagogiques produit

Ces besoins ne nécessitent pas d’édition adossée à une base de données dès le premier jour.

Pourquoi ne pas déployer immédiatement le runtime complet EmDash

EmDash peut fonctionner sur Cloudflare Workers avec D1 et R2, et c’est un élément important de sa proposition. Mais pour ce site, démarrer directement sur le runtime complet augmenterait les coûts d’infrastructure et la complexité de mise en place avant d’apporter une valeur significative.

L’approche static-first vous apporte :

  • un déploiement rapide sur Cloudflare Pages
  • des revues Git plus simples et une collaboration IA facilitée
  • aucun setup d’auth admin ou de stockage requis au lancement
  • une trajectoire plus claire pour itérer sur le messaging et l’architecture de l’information

Plus tard, si vous avez besoin de workflows éditoriaux dans le navigateur, de soumissions authentifiées ou d’une gestion média plus riche, vous pourrez migrer certaines sections vers un déploiement runtime complet EmDash.

Développement local

L’organisation actuelle du projet est volontaire :

  • src/ contient les routes, layouts et composants réutilisables
  • docs/ contient le contenu MDX publié

Cela permet de séparer proprement le travail de contenu et le travail frontend.

Lancez le site en local avec :

npm install
npm run dev

Construisez le site statique avec :

npm run build

Déploiement Cloudflare Pages

Pour le site statique actuel, Cloudflare Pages doit utiliser :

  • Commande de build : npm run build
  • Dossier de sortie : dist

Cela vous donne un site public avec une charge d’exploitation quasi nulle.

Quand passer à Workers, D1 et R2

Les ressources officielles EmDash indiquent clairement que la stack runtime est la plus pertinente quand vous avez besoin de vrais comportements CMS, notamment :

  • mises à jour de contenu en direct sans rebuild
  • collections adossées à une base de données
  • édition admin dans le navigateur
  • authentification via passkey ou Cloudflare Access
  • stockage média dans R2
  • plugins sandboxés sur Workers

C’est à ce moment qu’il faut passer d’une livraison Pages-only à la plateforme EmDash complète.

Prochaines étapes recommandées

Si vous lancez un site écosystème officiel EmDash, l’ordre pratique est :

  1. Publier le site public sur Astro et Cloudflare Pages
  2. Développer la doc, la FAQ, les guides de migration, les pages plugins et templates
  3. Utiliser le site pour valider le positionnement et le workflow de publication
  4. Introduire les fonctionnalités runtime complètes d’EmDash seulement quand les workflows éditoriaux ou écosystème l’exigent réellement