Redocly / Redocly/redoc

Sidebar nested menu expand/collapse has no animation (feels abrupt)

Open
#2,778 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
TypeScript
Stars
25.9k
Forks
2.4k
Avg merge
13h 10m
Merged PRs (30d)
4

Description

Describe the problem

First of all, thank you for Redoc — I use it frequently and it is very useful.

One UX gap I keep noticing is the left sidebar nested menu behavior:
expand/collapse is currently abrupt (no transition), which feels less modern than the rest of the UI.

Current behavior

When toggling nested items in the left sidebar, the submenu appears/disappears immediately.

Expected behavior

Submenu expand/collapse should animate smoothly (height-based accordion transition), while preserving current behavior:

  • active state handling
  • scroll syncing / auto-follow behavior
  • keyboard interaction and ARIA semantics
  • mobile and desktop layout stability
  • reduced motion support (prefers-reduced-motion)

Why this matters

The sidebar is a primary navigation surface in Redoc. Smoother transitions improve perceived quality and readability, especially in large specs.

Additional context

I already prepared a small, focused implementation and can open a PR if this direction is acceptable.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by locating the left sidebar nested-menu implementation and its existing expand/collapse behavior. Add a height-based transition while preserving active states, scroll syncing, keyboard and ARIA behavior, responsive layouts, and reduced-motion support; verify the submenu remains stable on desktop and mobile.

Written by the indexing model from the issue text.

Assessment

Tech stack
react, typescript
Domain
accessibility, frontend
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
52/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.