Repository navigation
feat(ui): Savanna API reference navigation and endpoint page layout - #56
Merged
Tushar-TG-14 merged 20 commits intoSep 24, 2026
Merged
Conversation
Split navigation into Platform, API reference, and Changelog tabs; render endpoint groups with HTTP method badges and always-expanded section titles.
Store nav menu scroll offset in sessionStorage keyed by menu identity so API reference browsing does not jump the sidebar on each endpoint page.
Use a viewport-based reading line instead of special-casing the page bottom so the TOC tracks the section you are reading on long API pages.
Split method badge and endpoint title so multi-line names wrap cleanly and reserve width for bold current-page styling.
Measure per-endpoint bold width ratios after fonts load and scroll the menu only when the current entry would be hidden after a cross-page navigation.
Style the two-column reference layout, language picker, and sample tabs, and align section tab indicators with in-page tab styling.
The API reference work changed the left menu's scroll behaviour, the on-this-page activation point, the breadcrumb version suffix, and the nav label markup for every component the bundle serves, not just the cloud ones. Gate each on the cloud theme so other components keep Antora's behaviour.
Render Postman's hosted button beside page actions when the page attribute is set.
Restyle listing and literal blocks with card borders, icon copy buttons, and copy support for unhighlighted pre blocks in the cloud theme.
Replace tip-green response tab accent with a darkened brand orange for contrast on small selected labels.
Center and scale language SVGs on a 24x24 canvas and enlarge masked icons so every sample tab aligns consistently.
Collaborator
|
Rebuild ui-bundle.zip so it includes the SEO metadata from main plus this PR's API reference UI.
Contributor
Author
|
Thanks @Tushar-TG-14 .
|
Merged
6 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Cloud theme updates to support the new Savanna REST API reference in
cloud-docs: navigation for large endpoint catalogs, dedicated endpoint page chrome, and small reading UX fixes.Navigation
nav-sections) in the toolbar on cloud-themed docs.API reference pages
api-reference.css+11-api-reference.js— two-column layout (main + examples), request/response UI, language picker icons.Page chrome & code blocks
page-postman-urlis set (page-actionspartial).Other
defaultdisplay version where appropriate.Companion change: pair with the cloud-docs PR that generates endpoint
.adocpages using thedata-api-referencemarkup this UI expects.Test plan
npx gulp bundlepasses; use the producedui-bundle.zipwith local Savanna preview.page-postman-urlis set.