Skip to content

PR8: feat: add design system documentation pages#1702

Open
anirudha wants to merge 2 commits intoopensearch-project:mainfrom
anirudha:v9-upstream/pr-8-design-system-docs
Open

PR8: feat: add design system documentation pages#1702
anirudha wants to merge 2 commits intoopensearch-project:mainfrom
anirudha:v9-upstream/pr-8-design-system-docs

Conversation

@anirudha
Copy link
Copy Markdown

@anirudha anirudha commented Feb 8, 2026

Add new Principles and Foundations documentation sections:

  • Principles: About OUI, Design Philosophy
  • Foundations: Color, Typography, Spacing & Layout, Elevation, Icons

Infrastructure changes:

  • Route registrations for all new pages
  • Sidebar styling improvements (gradient border, hidden scrollbar, fade-out)
  • Scroll position preservation on navigation
  • Page body padding adjustment
  • scrollIntoView behavior fix

PR 8: Design System Docs (~20 files)

Scope: All new documentation pages and docs site infrastructure changes.

Files included:

  • src-docs/src/views/design_system_principles/ (about_oui.tsx, design_philosophy.tsx)
  • src-docs/src/views/design_system_foundations/ (foundations_color.tsx, foundations_typography.tsx, foundations_spacing.tsx, foundations_elevation.tsx, foundations_icons.tsx)
  • src-docs/src/routes.js (route registrations)
  • src-docs/src/components/guide_components.scss (sidebar styling)
  • src-docs/src/components/guide_page/guide_page_chrome.js (minor update)
  • src-docs/src/views/app_view.js (minor update)
  • i18ntokens.json (token updates from new pages)

Note: Elevation docs (src-docs/src/views/elevation/) are included in PR 4 since they're tightly coupled to the elevation feature. Pattern pages are included here.

Testing: yarn lint, docs site compiles (yarn start), visual verification of all new pages

Add new Principles and Foundations documentation sections:
- Principles: About OUI, Design Philosophy
- Foundations: Color, Typography, Spacing & Layout, Elevation, Icons

Infrastructure changes:
- Route registrations for all new pages
- Sidebar styling improvements (gradient border, hidden scrollbar, fade-out)
- Scroll position preservation on navigation
- Page body padding adjustment
- scrollIntoView behavior fix

Signed-off-by: Anirudha Jadhav <anirudha@nyu.edu>
Signed-off-by: Anirudha (Ani) Jadhav <anirudha@nyu.edu>
Signed-off-by: Anirudha (Ani) Jadhav <anirudha@nyu.edu>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant