Skip to content

Visual Refresh of Docs UI (style.css only) #1895

@Gautam-Bharadwaj

Description

@Gautam-Bharadwaj

Summary: Visual Refresh of Docs UI (style.css only)

Scope:

  • All changes are CSS-only (style.css)
  • No edits to HTML, JavaScript, or content
  • Visual and polish-focused (colors, layout, shadows, typography, UI tokens)
  • Dark mode rules deliberately left untouched (follow-up planned)

Goals:

  • Modernize documentation UI
  • Increase professionalism and subtlety in visual design
  • Maintain or improve accessibility
  • Preserve all existing functionality (no behavioral changes)

Key Improvements:

  • Introduced a clean, neutral color palette (slate & blue, better theming)
  • Established UI tokens for radius and elevation (more consistent styling)
  • Refined typography: better line-height for reading, lighter h1, improved font selection
  • Flatter, more modern buttons: blue accent, reduced radius, softer shadow
  • Hero section: removed heavy white box, tightened spacing for clarity
  • Sidebar: now a professional card (white background, soft border, gentle shadow, consistent padding)
  • CTA button: inline & pill-shaped on wide screens (more integrated with hero)
  • Animation list: removed decorative gradients, hovered states are more subtle
  • Docs header: minimal, subtle border—no gradients or deep shadows
  • Code blocks: darker background, subtle border/radius, no heavy shadow
  • Layout: set max container width, harmonized spacing for easier reading
  • Visual polish: reduced border radii and heavy shadows throughout; gentler hover effects

Accessibility:

  • Maintained all prefers-reduced-motion/accessibility rules
  • Improved contrast and readability
  • No changes to dark mode (for stability—suggested as a follow-up)

File changes:

  • style.css: all changes are within this file

Reviewer notes:

  • Please visually verify:
    • Hero callout has no white box, CTA is inline on desktop
    • Sidebar uses new card style
    • All features (clipboard, toggles, animation demos) still work
  • Test standard, dark, and reduced-motion settings for regressions
  • Recommend follow-up PR for dark mode harmony

Suggested PR Title:
style(docs): professional visual refresh for docs (palette, typography, sidebar, CTA)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions