Express ha sido uno de los frameworks más importantes del ecosistema Node.js durante más de una década. Millones de desarrolladores han construido su primera API, su primera aplicación web, o incluso su primera startup con Express. Sin embargo, mientras el framework seguía evolucionando, el sitio web permaneció prácticamente igual durante años.
En 2024, el proyecto Express pasó por un reinicio importante. Un nuevo equipo, una visión renovada para el framework, y un camino claro a seguir. Ese ímpetu me inspiró a empezar a contribuir a Express con un objetivo simple: mejorar la experiencia de la documentación. La buena documentación ayuda a todos, desde principiantes construyendo su primer servidor hasta desarrolladores experimentados buscando el detalle correcto de una API, o incluso aquellos que construyen frameworks sobre Express. A principios de 2025, ese objetivo empezó a hacerse realidad cuando el rediseño de la documentación de Express arrancó oficialmente. Lo que comenzó como un esfuerzo de documentación eventualmente creció hasta convertirse en algo mucho más grande: un rediseño completo del sitio web y un logo completamente nuevo para Express.
En resumen: reconstruimos el sitio web de Express, mejoramos la experiencia de la documentación, e introducimos un nuevo logo e identidad visual que coincidan con la dirección del proyecto.
Un nuevo sitio web
Reconstruir el sitio web de Express no fue solo una actualización visual. También fue una oportunidad para repensar los fundamentos de cómo se organiza, genera y mantiene la documentación.
Internamente, pasamos de Jekyll a Astro, elegido tras una larga discusión comunitaria sopesando ventajas y desventajas y el mantenimiento a largo plazo. Nos dio la flexibilidad que necesitábamos para páginas ricas en contenido, un rendimiento sólido, un buen soporte de i18n, y un modelo de componentes que no nos encierra en un único framework de UI.
Novedades en la documentación
El rediseño también fue una oportunidad para incorporar mejoras largamente solicitadas en el funcionamiento de la documentación.
- Versionado mejorado. Las páginas de documentación ahora soportan múltiples versiones de Express en paralelo. Puedes leer la documentación de la versión que estás ejecutando realmente, y el contenido se mantiene estable a medida que se publican nuevas versiones. El sitio anterior no facilitaba esto, lo que a menudo llevaba a confusión entre versiones. Esto es especialmente útil ahora que Express 5 es la última versión estable y muchos proyectos siguen en Express 4.
- Búsqueda potenciada por IA. La nueva búsqueda está construida sobre Orama y va más allá de la coincidencia de palabras clave. Puedes hacer preguntas en lenguaje natural y obtener respuestas contextuales extraídas directamente de la documentación, lo que hace mucho más rápido encontrar la API o concepto adecuado.
- Soporte para
llms.txt. Cada sección de la documentación está ahora disponible a través de un endpointllms.txt, siguiendo la convención llms.txt. Esto facilita mucho el acceso a documentación precisa y actualizada de Express para modelos de lenguaje, asistentes de IA y otras herramientas.
Qué viene para la documentación
El lanzamiento del nuevo sitio es solo el comienzo. La siguiente fase de este esfuerzo se centra en la documentación misma, cerrando las brechas que se han acumulado a lo largo de los años y llevando cada API de Express al estándar que el framework merece.
Algunas de las cosas que vienen:
- Cerrar brechas de contenido. Muchas guías y referencias de API aún necesitan ejemplos nuevos, explicaciones más claras, o reescrituras que reflejen cómo se usa Express hoy en día, especialmente con Express 5.
- Mejores traducciones. El sitio tiene bases sólidas de i18n, pero la mayoría de las traducciones están incompletas o desactualizadas. El objetivo es que traducir la documentación de Express sea una contribución sencilla para cualquier hablante nativo.
- Mantener la documentación alineada con los lanzamientos. Las nuevas versiones de Express deberían publicarse con documentación ya lista, no ponerse al día meses después.
El nuevo sitio está diseñado para hacer que contribuir sea más fácil que nunca. Si ves algo que podría mejorarse, una explicación poco clara, un ejemplo que falta, o una traducción que necesita atención, por favor abre un issue o un pull request.
Un nuevo logo
Uno de los cambios más visibles es el logo completamente nuevo de Express. No fue algo que diseñamos de forma aislada. Salió de un taller colaborativo con el equipo de Orama, donde miembros de la comunidad y el Comité Técnico de Express se reunieron para definir quién es Express hoy y hacia dónde se dirige. Todo el proceso se manejó públicamente, para que cualquiera en la comunidad pudiera participar y compartir su voz.
Antes de pasar a la identidad visual, trabajamos juntos en los fundamentos que guiarían cada decisión de diseño.
Visión y misión
Empezamos haciéndonos dos preguntas simples: ¿qué es Express hoy, y a dónde queremos llevarlo? Las respuestas se convirtieron en la visión y misión que ahora guían cada decisión, desde el framework mismo hasta la documentación y la nueva identidad visual.
Valores de marca
Con la visión y misión definidas, las destilamos en tres valores que describen cómo Express se presenta ante sus usuarios. Estos anclan la nueva identidad y marcan el tono para todo lo que el proyecto comunica.
El logo
Con esa base en su lugar, el trabajo de diseño fue liderado por Angela Angelini y Davide Spaziani del equipo de Orama. Durante varios meses, se compartieron múltiples propuestas de logo con la comunidad para recibir comentarios. Todavía puedes explorarlas todas en la discusión original.
Después de recopilar comentarios de la comunidad, tanto en el Slack de la OpenJS Foundation como en redes sociales, llegamos al logo y favicon que ves hoy:
Representa un nuevo capítulo para Express manteniéndose fiel al minimalismo y la claridad que siempre han definido al framework.
Construido por la comunidad
El rediseño no fue un esfuerzo individual. Decenas de personas de toda la comunidad de Express contribuyeron con código, diseño, revisiones y comentarios durante más de un año.
El esfuerzo fue liderado por Sebastian Beltran, con Francesca Giannino impulsando gran parte del trabajo de diseño y UI en el nuevo sitio, y Angela Angelini y Davide Spaziani liderando el taller de marca que dio forma a la nueva identidad visual.
Un enorme agradecimiento al equipo de Orama por patrocinar a Francesca Giannino, Angela Angelini, Michele Riva, y Davide Spaziani, y por el diseño, comentarios y apoyo que aportaron en cada etapa del proyecto.
Desde el lado de Express, el rediseño fue moldeado por muchas manos: Ulises Gascón, Rand McKinney, Jon Church, Shubham Oulkar, el resto del Comité Técnico de Express, y todos los que contribuyeron con revisiones, issues o comentarios en el camino. El historial completo, incluyendo cada PR que formó parte del rediseño, está en el pull request principal.
Más de un año de trabajo se invirtió en este lanzamiento. En el código abierto, el progreso rara vez es rápido: las decisiones requieren discusión, el diseño requiere iteración, y las revisiones llevan tiempo. Pero paso a paso, una comunidad puede construir algo de lo que sentirse orgullosa, y este es uno de esos pasos.
Gracias a todos los que han escrito código con Express a lo largo de los años, a las personas que ayudaron a construir este nuevo sitio, y a la comunidad en general que mantiene vivo el proyecto. No podemos esperar a ver qué construyes a continuación.
