website icon indicating copy to clipboard operation
website copied to clipboard

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

Open Sourya07 opened this issue 1 month ago • 6 comments

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!)

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

Sourya07 avatar Dec 14 '25 18:12 Sourya07

Yes, I am interested in contributing to the fix.

Gopisokk avatar Dec 15 '25 02:12 Gopisokk

@Sourya07 can i work on this?

revaarathore11 avatar Dec 15 '25 08:12 revaarathore11

.take

AnuragGupta181 avatar Dec 15 '25 11:12 AnuragGupta181

Image hey after looking at the page the page is not responsive at all what i found the ASYNC API text is not coming in frame and also the text and divs are not properly centered what i can fix is make the text and divs and the all the things getting break which i think is some 4 to 5 places i will easily fix them hey maintainer please assign me i will make a pr with screenshot of fixed page

Anuragsharma15-dell avatar Dec 16 '25 06:12 Anuragsharma15-dell

Thank you for your interest and feedback. I’m currently working on addressing this issue.

Sourya07 avatar Dec 16 '25 06:12 Sourya07

oh ok if you need any help feel free to ask

Anuragsharma15-dell avatar Dec 16 '25 06:12 Anuragsharma15-dell

This is a complex layout and I feel like we shouldn't support mobile view for this page. A better workaround would be to display a full screen message appealing users to shift to a large screen to experience the graphs.

anshgoyalevil avatar Dec 21 '25 16:12 anshgoyalevil

Please create another issue to tackle the workaround task.

anshgoyalevil avatar Dec 21 '25 16:12 anshgoyalevil