Conoce Rspress: Un generador de sitios potenciado por Rust

Si mantienes una biblioteca de componentes React o un proyecto orientado a desarrolladores, probablemente hayas lidiado con el mismo dilema: herramientas de documentación que son rápidas pero limitadas, o flexibles pero lentas. Rspress está diseñado para cerrar esa brecha.

¿Qué es Rspress?

Rspress es un generador de documentación React y generador de sitios estáticos construido sobre Rsbuild y potenciado por el empaquetador Rspack, un empaquetador basado en Rust compatible con webpack. Para ser precisos: Rspress en sí es un framework React, no una aplicación Rust. Las mejoras de rendimiento provienen de la cadena de herramientas de compilación en Rust de Rspack por debajo, mientras que tú escribes tu documentación y componentes en React y MDX como lo harías normalmente.

Es parte del ecosistema más amplio Rstack, una cadena de herramientas JavaScript unificada construida alrededor de Rspack, que también incluye Rsbuild, Rslib, Rsdoctor y Rstest.

Rspress se enfoca en dos casos de uso principales: sitios de documentación para desarrolladores y documentación de bibliotecas de componentes. Soporta MDX de forma nativa, lo que significa que puedes incrustar componentes React en vivo directamente dentro de tus páginas Markdown, útil cuando necesitas ejemplos interactivos junto con explicaciones escritas.

Novedades en Rspress 2.0

Rspress 2.0, lanzado a principios de 2026, va más allá del rendimiento puro de compilación. Esto es lo que cambió.

Un sistema de temas rediseñado

El tema predeterminado recibió una renovación visual completa. Más importante aún, la versión 2.0 introduce cuatro niveles de personalización:

• Variables CSS: ajusta colores, fondos de bloques de código y estilos de diseño
• Nombres de clase BEM: sobrescribe estilos de componentes sin conflictos con frameworks CSS
• Sobrescrituras de re-exportación ESM: reemplaza cualquier componente integrado mediante theme/index.tsx
• Expulsión de componentes: copia el código fuente de un componente a tu proyecto con rspress eject [component] y modifícalo directamente

Esto reemplaza la API de temas inestable de 1.x y te proporciona una ruta de personalización predecible y por capas.

Shiki para resaltado de sintaxis en tiempo de compilación

Rspress 2.0 reemplaza el resaltado en tiempo de ejecución con Shiki, que se ejecuta en tiempo de compilación. Esto significa cero sobrecarga en tiempo de ejecución, resaltado preciso al estilo de VS Code mediante gramáticas TextMate, y soporte para transformadores como @rspress/plugin-twoslash para sugerencias de tipos TypeScript en línea.

Inicios de desarrollo más rápidos con compilación diferida

lazyCompilation ahora está habilitado por defecto. Las páginas solo se compilan cuando las visitas durante el desarrollo, lo que significa que el inicio es casi instantáneo sin importar cuán grande sea tu sitio de documentación. Una estrategia de precarga de rutas al pasar el cursor sobre los enlaces mantiene la navegación fluida.

El almacenamiento en caché persistente también está activado por defecto, reduciendo los tiempos de compilación en arranque en caliente en un 30-60%.

Documentación compatible con IA mediante SSG-MD

Rspress 2.0 introduce SSG-MD (Static Site Generation to Markdown), una característica que renderiza tu documentación como archivos Markdown limpios junto con la salida HTML estándar, y luego genera archivos llms.txt y llms-full.txt siguiendo la especificación llms.txt.

import { defineConfig } from '@rspress/core';

export default defineConfig({
  llms: true,
});

A diferencia de convertir HTML a Markdown después del hecho, SSG-MD trabaja desde el DOM virtual de React durante el renderizado, produciendo una salida de mayor calidad. También puedes controlar qué se incluye por componente usando import.meta.env.SSG_MD. Ten en cuenta que esta característica aún está madurando, y el equipo ha señalado refinamientos adicionales como parte de la hoja de ruta.

Consolidación de paquetes

En la versión 2.0, los antiguos paquetes rspress, @rspress/runtime, @rspress/shared y @rspress/theme-default se fusionan en un único paquete @rspress/core. El framework ahora requiere Node.js 20+ y React 18 o 19.

¿Deberías usar Rspress?

Rspress es una opción sólida si estás construyendo documentación para un proyecto React o una biblioteca de componentes y deseas compilaciones rápidas, soporte MDX y un tema que realmente puedas personalizar. Se integra directamente con Rslib para flujos de trabajo de bibliotecas de componentes, y el ecosistema de plugins —incluyendo búsqueda Algolia, generación de sitemap y twoslash— cubre la mayoría de las necesidades de sitios de documentación.

Si tu proyecto usa Vue o Svelte, o necesitas un ecosistema más establecido, VitePress o Docusaurus siguen siendo alternativas sólidas. Pero para documentación centrada en React, Rspress 2.0 merece una mirada detallada.

Preguntas frecuentes

Gain Debugging Superpowers

Unleash the power of session replay to reproduce bugs, track slowdowns and uncover frustrations in your app. Get complete visibility into your frontend with OpenReplay — the most advanced open-source session replay tool for developers. Check our GitHub repo and join the thousands of developers in our community.