Multi repo site

[skoppe]

We want to run our full internal docs on rspress, but for this we ideally need another level of navigation to be able to serve each department in the organisation.

I suspect I will have to go the route that rspress themselves use, i.e. have a top-left expandable menu with each of the different products/departments. I was hoping to avoid that because I do want search to be across all docs without the need to hop back-and-forth.

Thanks in advance and appreciate the product.

[SoonIter]

Thanks for your support!

This is indeed a common challenge for static site generators, and we've faced similar requirements ourselves. Here are a few approaches our team has been using:

1. Rstack (https://rspack.rs): Each product maintains its own domain and Rspress project. We use the expandable menu in the top-left corner to navigate between them, which requires jumping across different domains (essentially a multi-domain + multiple Rspress projects setup, similar to MPA).

As for searchIndex, If you need to search across multiple sites, you may need a service like Algolia to implement a multi-site search index.

2. Lynx (https://lynxjs.org/next/react/introduction.html): All product docs are maintained in a single monorepo (https://github.com/lynx-family/lynx-website) and switched via the navbar (single domain + single Rspress project, essentially SPA).

Regarding support for multiple Git repositories, this is quite difficult to achieve because static site generation relies on a one-time compilation process to produce HTML and other assets.

You'd either need to combine them into a single domain + single Rspress project (using git submodules / pnpm git protocol), or go with the multiple domains + multiple Rspress projects approach.