Construyendo Rush CMS: ¿Cómo es el Design System de mi Headless CMS?

Desarrollar un Headless CMS desde cero no se trata solo de CRUDs; se trata de gestionar complejidad, garantizar consistencia visual a escala y tomar decisiones técnicas basadas en ROI. Rush CMS nació de una necesidad mía, y del mercado. Pero su fundación fue construida bajo los principios de Design Systems y Clean Architecture.
En este post, abro el capó de las decisiones de diseño e infraestructura que sostienen el proyecto hoy en producción. Prepárate para ver el motivo por el que cada pieza del motor fue pensada. Debo recordar que Rush CMS - por ahora - es un proyecto cerrado, de uso propio.
Pero ¿por qué demonios desarrollar un CMS desde cero, si ya existen WordPress, Strapi, Contentful...?
Es una buena pregunta, y fue lo primero que pregunté cuando empecé. Pero la respuesta es más fácil de lo que parece: no estoy reinventando la rueda, estoy usando las ruedas correctas. Necesitaba un CMS headless que fuera:
Probé las otras opciones. WordPress ya nace tachado — incluso con el excelente Sage, no es headless de verdad, y la API REST es... digamos, una experiencia. ¿Strapi? Node.js sin multi-tenancy nativo; recomiendan múltiples instancias. ¿Contentful? Prepárate para un lock-in pesado y pricing por tenant. Todas estas alternativas son excelentes para lo que ofrecen. No estoy compitiendo con ellas.
Rush CMS fue hecho para agencias y plataformas que necesitan gestionar decenas de sitios de clientes en una única instancia, con aislamiento real e internacionalización nativa.Actualmente estoy corriendo pruebas con clientes antes de abrirlo a escala.
Conoce la anatomía de Rush CMS
Antes de hablar sobre las decisiones, profundicemos en el design system de forma pura y clara. Si quieres profundizar en lo que hace Rush, visita el sitio oficial:
¿Qué se usa?
- Gateway
- Interface en Filament
- API agnóstica con endpoints protegidos, entrega de JSON puro para el front-end
- Engine
- App con Laravel 12 + PHP 8.4 (Strict Typing + PHPStan lvl5)
- Performance con Laravel Octane (Swoole)
- Data Persistence
- PostgreSQL (JSONB para la flexibilidad de las Collections)
- Redis para queues y cache
- DevOps
- Docker
- Coolify
- Hetzner
- CI/CD
- GitHub Actions corriendo 600+ tests (Pest)
- Pint
- PHP Stan
- Frontend Build
Background y Workers
- Job de Imagen: Upload a S3 → Resize Worker → WebP converter → CDN
- i18n Engine: El CMS es i18n-first, nativamente soporta varios idiomas en los contenidos, utilizando Spatie integrado a los Models para traducción on-the-fly
- Integraciones:
- API interna de consumo para los sitios web
- Google Analytics Oauth2
- Observability & Reliability:
- Google Analytics
- Webhooks de deploy (para sitios estáticos)
- Triple capa de backup (Spatie, Hetzner, Coolify)
Ok, ahora que ya sabes lo que tiene, entendamos algunos motivos de por qué se hizo de esta forma.
El Design System como Pilar de Escalabilidad
En la época de los dinosaurios era común empezar por la base de datos. Yo empecé por la consistencia. Para un CMS multi-tenant, el Design System no es sobre "estética", es sobre eficiencia operativa. Primero tengo que documentar todo lo que necesito, antes de poner la mano en cualquier línea de código.
Sobre Filament y Tailwind
Utilicé el ecosistema de Filament para heredar un sistema de componentes robusto para el panel de control. Eso permitió enfocarme en lo que es core para el negocio: la creación de Custom Blocks, Collections, Databases.
Aquí hago una confesión: me gustaría MUCHO desacoplar completamente el frontend y usar React puro, pero sería una pésima decisión para lo que el proyecto necesitaba, así que - con una lágrima en los ojos, y los pies en la tierra - seguí con Filament, una decisión técnica basada en ROI, garantizando accesibilidad y usabilidad nativas sin reinventar patrones de UI estables.
Contract Driven Design
La inteligencia del Design System está en el Schema de la API. El usuario puede crear decenas de bloques personalizados, pero la responsabilidad de "entender" y renderizar esos bloques es del front-end desacoplado.
El CMS dicta la estructura del dato, y el consumidor de la API implementa la visualización. Ese contrato riguroso es lo que garantiza que se puedan crear nuevos tipos de contenido sin romper la integridad visual del producto final. Es una excelente forma de que el desarrollador front-end pueda tener un sitio extremadamente dinámico a través del panel de control, y hacer el front-end con todas sus preferencias personales.
Decisiones Técnicas y Trade-offs
Aquí, mi foco fue minimizar el Time-to-Market sin comprometer la calidad.
Multi-tenancy y Aislamiento Zero Trust
La arquitectura de multi-tenancy fue implementada con foco total en el desacoplamiento entre tenants a través del package Filament Shield. No existe un "Super User" con acceso irrestricto a los datos de todos los clientes por defecto.
Si mi acceso es revocado por el administrador de un sitio, el aislamiento es total. Es una elección de diseño que prioriza la soberanía de datos del cliente por encima de la conveniencia técnica del desarrollador. Para el seguimiento contractual, los únicos accesos que tengo son: espacio ocupado en S3 y API requests.
Performance con Laravel Octane
Esta decisión puede leerse de varias formas, como anticipada o correcta. ¿Por qué es correcta? Rush CMS fue proyectado para atender diversos sitios en tiempo real, tanto SSR, ISR o SSG, y una refactorización de la plataforma con 100+ sitios corriendo simultáneamente traería más trabajo que dejarlo listo ahora. Incluso si no fuera a usar Octane ahora, ya tendría que escribir el sistema preparado para él, con todos los cuidados de datos necesarios, lo que muestra aún más el sentido de traer velocidad lo antes posible.
Por eso, la transición a un servidor in-memory con Octane en el commit #247 fue estratégica, pavimenta el camino hacia escalas mayores. Estoy recolectando métricas de producción con clientes de prueba para validar el impacto real en la latencia y el throughput.
Postgres y JSONB
La flexibilidad exigida por un CMS de colecciones dinámicas pide esquemas mutables. El uso de JSONB en Postgres permitió unir la potencia de las herramientas NoSQL con la seguridad e integridad del ecosistema relacional del Eloquent ORM.
Calidad de Software y Feedback Loops
Un sistema en producción con clientes reales no puede ser frágil.
Estrategia de Tests
Rush CMS cuenta hoy con 600+ tests automatizados (Pest PHP), todavía está lejos de la totalidad, pero cubre todo el "core system". El foco actual no es la cobertura por vanidad, sino la protección de la lógica de precios, los permisos y la integridad del multi-tenancy.
Integridad del Código
Actualmente en PHPStan Level 5, con roadmap hacia el Level 8/9 (la mano me pica para hacerlo ya jajaja). Mantener el código tipado y analizado es lo que me permite hacer deploys diarios con mayor confianza (uso CI/CD desde el día 1).
Image Pipeline
Implementé un sistema de optimización WebP vía S3 desde el inicio. Refactorizar pipelines de media después de tener miles de archivos es una pesadilla de costos y migración; lo resolví como una feature de core desde el comienzo, así garantizo un S3 flaquito y evito la inevitable refactorización en el futuro.
Lecciones de ROI
¿Qué haría diferente? ¡Es importante aprender de los propios errores, para no repetirlos después! Los dos errores que voy a mencionar son iguales, en aplicaciones diferentes, intenté reinventar la rueda:
- i18n: Intenté crear un sistema de traducción propio antes de migrar a Spatie Translatable. Lección: Usa soluciones battle-tested para problemas comunes.
- Analytics Interno: Construí un motor de analytics completo antes de darme cuenta de que el foco del producto debía ser el CMS, no el monitoreo. Lo sustituí por integraciones nativas (Google Analytics/OAuth2), ahorrando horas de mantenimiento.
¿Qué me parece Rush, hasta ahora?
Rush CMS es un testimonio de que velocidad y calidad no son mutuamente excluyentes, siempre que tengas un Design System sólido y una estrategia de tests rigurosa. Actualmente, el proyecto sigue evolucionando, ya con planes de mediano, largo y larguísimo plazo.
El feedback de los clientes que están probando la plataforma es positivo, ¡hay mucho trabajo por delante! Sobre Métricas de Performance, estoy recolectando datos de performance y comportamiento en producción de los clientes de prueba. En un futuro post voy a abordar benchmarks reales de latencia, throughput y consumo de recursos. No sería honesto tirar números comparativos aquí, si todavía no los he contabilizado por el tiempo suficiente.