Skip to content

[DESIGN]: Specification Explorer is not usable on small screens (mobile / small laptops) #4713

@Sourya07

Description

@Sourya07

Describe the Issue

Page:
https://www.asyncapi.com/docs/reference/specification/v3.0.0-explorer
The Specification Explorer page is not responsive and provides a poor user experience on small screens (mobile devices and small laptop viewports).

On narrow viewports:
• The left visual schema/map overlaps or consumes most of the screen
• The right-side content becomes cramped and hard to read
• Horizontal scrolling is required
• Important content is partially hidden or inaccessible
• Zooming or resizing does not resolve layout issues

This makes the page effectively unusable on mobile and inconvenient even on smaller laptops.

Expected Outcome

•	Responsive layout that adapts to small screens
•	Collapsible or toggleable schema explorer
•	Content-first layout on mobile
•	No horizontal scrolling
•	Readable typography and spacing

Screenshots

.....

Steps to Reproduce

    1.	  Open the page on a mobile device

or
2. Open in desktop browser and resize width below ~700px
3. Observe layout behavior

Browser/Device

mac

Additional Notes

.

Check Before Submitting

Would you like to help fix this issue? (Not required, but appreciated!)

  • Yes, I am interested in contributing to the fix.
  • No, I am just reporting the issue.

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