Conheça o Rspress: Um Gerador de Sites Alimentado por Rust
Se você mantém uma biblioteca de componentes React ou um projeto voltado para desenvolvedores, provavelmente já enfrentou o mesmo dilema: ferramentas de documentação que são rápidas mas limitadas, ou flexíveis mas lentas. O Rspress foi construído para preencher essa lacuna.
Principais Destaques
- Rspress é um gerador de sites estáticos baseado em React, alimentado pela toolchain de build Rspack em Rust, oferecendo builds rápidos com suporte completo a MDX.
- A versão 2.0 introduz um sistema de temas em camadas, destaque de sintaxe em tempo de build com Shiki, compilação lazy por padrão e saída Markdown amigável para IA via SSG-MD.
- Todos os pacotes principais foram consolidados em
@rspress/core, exigindo Node.js 20+ e React 18 ou 19. - Rspress é mais adequado para documentação React-first e sites de bibliotecas de componentes; projetos Vue ou Svelte podem ser melhor atendidos por VitePress ou Docusaurus.
O Que É o Rspress?
Rspress é um gerador de documentação React e gerador de sites estáticos construído sobre o Rsbuild e alimentado pelo bundler Rspack — um bundler baseado em Rust e compatível com webpack. Para ser preciso: o Rspress em si é um framework React, não uma aplicação Rust. Os ganhos de performance vêm da toolchain de build do Rspack alimentada por Rust por baixo, enquanto você escreve sua documentação e componentes em React e MDX como normalmente faria.
Ele faz parte do ecossistema mais amplo Rstack — uma toolchain JavaScript unificada construída em torno do Rspack — que também inclui Rsbuild, Rslib, Rsdoctor e Rstest.
O Rspress tem como alvo dois casos de uso principais: sites de documentação para desenvolvedores e documentação de bibliotecas de componentes. Ele suporta MDX nativamente, o que significa que você pode incorporar componentes React interativos diretamente dentro de suas páginas Markdown — útil quando você precisa de exemplos interativos junto com explicações escritas.
O Que Há de Novo no Rspress 2.0
O Rspress 2.0, lançado no início de 2026, vai além da performance bruta de build. Veja o que mudou.
Um Sistema de Temas Redesenhado
O tema padrão recebeu uma reformulação visual completa. Mais importante, a versão 2.0 introduz quatro níveis de customização:
- Variáveis CSS — ajuste cores, backgrounds de blocos de código e estilos de layout
- Nomes de classe BEM — sobrescreva estilos de componentes sem conflitos com frameworks CSS
- Sobrescrita de re-exportação ESM — substitua qualquer componente embutido via
theme/index.tsx - Ejeção de componente — copie o código-fonte de um componente para seu projeto com
rspress eject [component]e modifique-o diretamente
Isso substitui a API de temas instável da versão 1.x e oferece um caminho de customização previsível e em camadas.
Shiki para Destaque de Sintaxe em Tempo de Build
O Rspress 2.0 substitui o destaque de sintaxe em runtime pelo Shiki, que roda em tempo de compilação. Isso significa zero overhead em runtime, destaque preciso no estilo VS Code via gramáticas TextMate, e suporte para transformers como @rspress/plugin-twoslash para dicas de tipo TypeScript inline.
Discover how at OpenReplay.com.
Inicialização Mais Rápida em Dev com Compilação Lazy
lazyCompilation agora está habilitado por padrão. As páginas são compiladas apenas quando você as visita durante o desenvolvimento, o que significa que a inicialização é quase instantânea, independentemente do tamanho do seu site de documentação. Uma estratégia de pré-carregamento de rotas ao passar o mouse sobre links mantém a navegação fluida.
O cache persistente também está ativo por padrão, reduzindo os tempos de build em warm-start em 30–60%.
Documentação Amigável para IA com SSG-MD
O Rspress 2.0 introduz SSG-MD (Static Site Generation to Markdown) — um recurso que renderiza sua documentação como arquivos Markdown limpos junto com a saída HTML padrão, e então gera arquivos llms.txt e llms-full.txt seguindo a especificação llms.txt.
import { defineConfig } from '@rspress/core';
export default defineConfig({
llms: true,
});Diferentemente de converter HTML para Markdown após o fato, o SSG-MD trabalha a partir do DOM virtual React durante a renderização, produzindo uma saída de maior qualidade. Você também pode controlar o que é incluído por componente usando import.meta.env.SSG_MD. Note que este recurso ainda está amadurecendo, e a equipe sinalizou refinamentos adicionais como parte do roadmap.
Consolidação de Pacotes
Na versão 2.0, os antigos pacotes rspress, @rspress/runtime, @rspress/shared e @rspress/theme-default foram mesclados em um único pacote @rspress/core. O framework agora requer Node.js 20+ e React 18 ou 19.
Você Deveria Usar o Rspress?
O Rspress é uma ótima escolha se você está construindo documentação para um projeto React ou biblioteca de componentes e quer builds rápidos, suporte a MDX e um tema que você possa realmente customizar. Ele se integra diretamente com Rslib para fluxos de trabalho de bibliotecas de componentes, e o ecossistema de plugins — incluindo busca Algolia, geração de sitemap e twoslash — cobre a maioria das necessidades de sites de documentação.
Se seu projeto usa Vue ou Svelte, ou você precisa de um ecossistema mais estabelecido, VitePress ou Docusaurus continuam sendo alternativas sólidas. Mas para documentação React-first, o Rspress 2.0 vale uma análise mais detalhada.
Perguntas Frequentes
O Rspress oferece tempos de build mais rápidos graças ao seu bundler Rspack alimentado por Rust e vem com recursos como compilação lazy e cache persistente por padrão. O Docusaurus tem um ecossistema de plugins maior e uma comunidade mais ampla. Se velocidade bruta de build e integração estreita com Rstack são mais importantes, Rspress é a escolha mais forte. Para um ecossistema mais maduro, Docusaurus continua confiável.
Sim, mas você precisará atualizar seus imports já que todos os pacotes principais agora estão consolidados sob @rspress/core. A API de temas também mudou, então quaisquer sobrescritas de tema personalizadas construídas contra a API 1.x precisarão ser refatoradas para usar o novo sistema de customização em camadas. A equipe do Rspress fornece um guia de migração na documentação oficial.
Não. O Rspress é projetado especificamente para React e MDX. Se seu projeto usa Vue, VitePress é uma alternativa bem suportada. Para Svelte ou outros frameworks, você precisaria procurar geradores de sites estáticos diferentes. O Rspress foca em fazer documentação React-first bem feita, em vez de tentar suportar múltiplos frameworks.
SSG-MD gera arquivos Markdown limpos a partir da sua documentação junto com a saída HTML padrão. Ele também produz arquivos llms.txt que seguem uma especificação emergente para tornar o conteúdo do site acessível a modelos de linguagem grandes. Isso é útil se você quer que ferramentas de IA referenciem sua documentação com precisão. O recurso trabalha a partir do DOM virtual React para uma saída de maior qualidade.
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.
