Démarrer avec EmDash CMS
Installer, lancer et tester un projet EmDash en quelques minutes. Une approche différente de WordPress, conçue pour corriger ses limites historiques.
🧭 AVANT DE COMMENCER : Pré-requis
EmDash reste un projet en développement actif. Avant de commencer, assurez-vous d’avoir un environnement de développement standard et d’être à l’aise avec les bases du CLI et du JavaScript. → Objectif : pouvoir tester rapidement sans blocage technique
Node.js
Node.js récent installé
CLI
Accès à un terminal (CLI)
Cloudflare
Compte Cloudflare (recommandé pour le déploiement)
JavaScript
Connaissances de base en JavaScript / TypeScript
⚙️ INSTALLATION : Installer un projet EmDash
Le moyen le plus simple pour démarrer est d’utiliser le CLI officiel. Il permet de générer un projet prêt à être lancé en local.
Commande
`npx create-emdash@latest` Suivez les étapes dans le terminal pour initialiser votre projet.
💻 LANCER EN LOCAL : Lancer le projet en local
Une fois le projet installé, vous pouvez démarrer l’environnement de développement local. → Vous pouvez explorer la structure, modifier le contenu et observer le rendu en temps réel.
Commandes
`cd mon-projet` `npm install` `npm run dev` Le site sera accessible sur un serveur local, généralement via http://localhost:3000.
🧱 COMPRENDRE LA STRUCTURE
Un projet EmDash est plus proche d’un projet front-end moderne que d’un CMS classique. Vous ne manipulez pas un back-office lourd, mais une structure de fichiers et de composants. → Résultat : une approche plus proche du code que de l’interface admin
Pages
définies dans le routing Astro
Contenu
stocké sous forme structurée (Portable Text / JSON)
Composants
blocs réutilisables (Hero, Features, FAQ)
Seed
configuration initiale du contenu
☁️ DÉPLOIEMENT : Déployer sur Cloudflare
EmDash est conçu pour fonctionner sur Cloudflare Workers. Le déploiement permet de bénéficier du modèle serverless et de l’exécution au edge. → Résultat : un site distribué globalement, sans serveur à gérer
Compte
Créer un compte Cloudflare
Configuration
Configurer le projet avec les outils Cloudflare
Déploiement
Déployer via CLI ou intégration Git
⚠️ LIMITES À CONNAÎTRE : Points d’attention
EmDash n’est pas encore une solution mature pour tous les usages. Avant de l’utiliser sur un projet réel, gardez en tête certaines limitations. → Recommandé pour tests, prototypes ou projets internes
Plugins
Écosystème de plugins limité
Permissions
Modèle de permissions encore en évolution
Documentation
Documentation incomplète
Administration
Outils admin encore basiques
🚀 PROCHAINES ÉTAPES : Aller plus loin
Une fois votre premier projet lancé, vous pouvez approfondir certains aspects du CMS. → Objectif : comprendre ce que permet réellement l’architecture EmDash
Plugins
Explorer les plugins et leur modèle de permissions
Contenu
Modifier la structure de contenu
Intégrations
Tester des intégrations avec des APIs ou des agents IA
Performances
Analyser les performances en environnement serverless