Primeros pasos
Comprende qué es EmDash CMS, sobre qué stack está construido y cuál es la mejor forma de lanzar hoy un sitio oficial de contenidos con EmDash.
Qué es EmDash CMS
EmDash CMS se presenta públicamente como un CMS full-stack en TypeScript, construido sobre Astro y diseñado para funcionar especialmente bien en Cloudflare. El producto mantiene varios conceptos que mucha gente ya conoce de WordPress, entre ellos:
- colecciones y tipos de contenido
- taxonomías, menús y widgets
- una interfaz de administración para editores
- un modelo de plugins para extender el comportamiento del sitio
La diferencia es que EmDash está construido alrededor de herramientas modernas de frontend, contenido tipado y opciones de despliegue nativas de Cloudflare, en lugar de hosting con PHP.
Qué lo diferencia de un CMS típico
Según la documentación pública oficial y los materiales del repositorio, hay varios puntos constantes:
- EmDash es nativo de Astro, no un SaaS independiente al que llamas por API
- usa TypeScript en todo el stack
- está diseñado para ser portable en la nube
- su modelo de plugins se basa en ejecución aislada en Cloudflare Worker isolates
- usa contenido estructurado en lugar de depender de almacenamiento HTML al estilo WordPress
Esa combinación es lo que lo hace interesante para un sitio de ecosistema público como emdashcmseverything.com.
Primera versión recomendada para este sitio web
Aunque EmDash admite una arquitectura CMS en runtime, la mejor primera versión de este sitio sigue siendo un sitio estático de contenido en Astro.
Para este proyecto, el stack recomendado es:
Astropara el framework del sitioMDXpara contenido largo y páginas de recursosCloudflare Pagespara hosting de bajo costoGit + edición con IApara publicación continua
Este es el punto de partida correcto porque tu sitio es principalmente:
- documentación
- FAQ y guías de migración
- contenido de directorios de plugins y plantillas
- actualizaciones, tutoriales y material educativo del producto
Estas necesidades no requieren edición con base de datos desde el primer día.
Por qué no desplegar de inmediato el runtime completo de EmDash
EmDash puede ejecutarse en Cloudflare Workers con D1 y R2, y esa es una parte importante de la propuesta del producto. Pero para este sitio, comenzar directamente con el runtime completo aumentaría el costo de infraestructura y la complejidad de configuración antes de aportar mucho beneficio.
La versión estática inicial te aporta:
- despliegue rápido en Cloudflare Pages
- revisión en Git más simple y colaboración con IA más fácil
- sin necesidad de configurar autenticación de administración ni almacenamiento para lanzar
- una ruta más limpia para iterar el mensaje y la arquitectura de información
Más adelante, si necesitas flujos editoriales en navegador, envíos autenticados o gestión de medios más rica, puedes mover secciones concretas a un despliegue con runtime completo de EmDash.
Desarrollo local
El proyecto actual está organizado de forma intencional:
src/contiene rutas, layouts y componentes reutilizablesdocs/contiene el contenido MDX publicado
Esto significa que el trabajo de contenido y el trabajo de frontend están claramente separados.
Ejecuta el sitio en local con:
npm install
npm run dev
Compila el sitio estático con:
npm run build
Despliegue en Cloudflare Pages
Para el sitio estático actual, Cloudflare Pages debe usar:
- Comando de build:
npm run build - Directorio de salida:
dist
Esto te da un sitio público con operación casi nula.
Cuándo pasar a Workers, D1 y R2
Los materiales oficiales de EmDash dejan claro que el stack con runtime es más fuerte cuando necesitas comportamiento real de CMS, especialmente:
- actualizaciones de contenido en vivo sin rebuilds
- colecciones respaldadas por base de datos
- edición administrativa en navegador
- autenticación con passkeys o Cloudflare Access
- almacenamiento de medios en R2
- plugins aislados en Workers
Ese es el momento adecuado para pasar de una entrega solo con Pages a la plataforma completa de EmDash.
Próximos pasos recomendados
Si vas a lanzar un sitio oficial del ecosistema EmDash, el orden práctico es:
- Publicar el sitio público en Astro y Cloudflare Pages
- Construir documentación, FAQ, guías de migración, páginas de plugins y páginas de plantillas
- Usar el sitio para validar posicionamiento y flujo de publicación
- Introducir funciones del runtime completo de EmDash solo cuando los flujos editoriales o de ecosistema realmente lo necesiten