Skip to content

Feature Request: Support for Multiple Navigation Hierarchies (Similar to Docusaurus Multiple Sidebars) #788

@ApolonTorq

Description

@ApolonTorq

Consider adding support for multiple, independent navigation hierarchies, similar to how Docusaurus supports “multiple sidebars.” This would enable documentation sites to display and switch between entirely different navigation menus/hierarchies (for example, API docs, Tutorials, User Guides, etc.), instead of being limited to a single sidebar derived from the folder tree.

Background/Problem:

Currently, Retype only allows for one main navigation sidebar, which is built from the project’s folder structure. While the new "stack mode" improves the visual grouping of top-level folders, all navigation still comes from a single hierarchy. In large or complex doc sites with different content types or product lines, this approach becomes limiting, as it’s not possible to define, display, or switch between completely separate (and context-specific) navigation trees.

Inspiration:

Docusaurus provides the ability to define multiple independent sidebars, each with its own hierarchy, and allows users to switch between them. This allows for highly flexible documentation sites, where, for example, top-level tabs/menus, or context switches, expose entirely different document structures.

Requested Functionality:

  • Ability to define multiple navigation sidebars/hierarchies in the project configuration.
  • Support for presenting these navigation options in different UI locations (sidebar, top menu, etc.).
  • Option for users to switch between navigation contexts (e.g., via tab, dropdown, or top menu).
  • Each hierarchy can be built from a separate folder, file, or config section.
  • Ideal for segmenting docs by product, persona, or content type.

Value:

This would make Retype much more scalable and user-friendly for enterprise-sized documentation and multi-product sites

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions