Skip to content

Redesign homepage below-hero sections#149

Merged
Blargian merged 1 commit into
ClickHouse:mainfrom
danielclickh:feat/homepage-below-hero
Jun 9, 2026
Merged

Redesign homepage below-hero sections#149
Blargian merged 1 commit into
ClickHouse:mainfrom
danielclickh:feat/homepage-below-hero

Conversation

@danielclickh

@danielclickh danielclickh commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Replaces removed section titles with h2 + subtitle format (consistent with MCP section style)
  • Removes thumbnail images from use case cards; adds bottom-right yellow/black arrow
  • Adds full-width horizontal dividers above/below use case section and below product section (fixed to span sidebar → viewport right using getElementById('sidebar'))
  • Adds hover states to all HeroCards: dark #272727 bg / #535353 border; light #f0f0f0
  • Redesigns product section: ClickHouse Cloud spans 2 cols with rich description + 5 bullet links, flanked by 3 stacked cards (ClickStack, Managed Postgres, chDB), then a 3-col row (LangFuse, Kubernetes Operator, chDB)
  • Adds bottom-right corner arrows to all product cards
  • Consistent 24px spacing between section subtitle and card grids across all sections
  • All changes applied to locale files (ru, es, ja, ko, pt-br, zh)

Note: This PR is stacked on top of feat/homepage-hero-ui (#140). Once that merges, this branch will be rebased onto main and the diff will show only below-hero changes.

Test plan

  • Light and dark mode: check hover states, arrow colors (black light / yellow dark), divider line colors
  • Full-width divider lines span from sidebar right edge to viewport right at all screen sizes
  • Product section layout: 2-col ClickHouse Cloud + 3 stacked, then 3-col row
  • Section headers (h2 + subtitle) appear above use case cards, product cards, and MCP section
  • All locale pages render correctly

🤖 Generated with Claude Code


Note

Low Risk
Presentation-only changes to Mintlify homepage MDX and CSS; main review risk is layout/resize edge cases for FullWidthDivider and duplicated chDB entries on the English product row.

Overview
Redesigns the docs homepage content below the hero by extending shared HeroCard / ContentSwitcher pieces and adding global styles for cards, section dividers, and corner arrows.

HeroCard gains optional custom body, showArrow / arrowBottom, extraStyle, image-less cards, and link cards that use preventDefault + window.location.href for navigation. FullWidthDivider is new: a resize-aware <hr> that stretches from the sidebar’s right edge to the viewport so section rules read full-width.

Use case block: stacked-mode section headers become h2 + subtitle; FullWidthDivider wraps the section on the English page; several cards drop hero thumbnails and use bottom-right arrows instead (Observability on locales too).

English index.mdx only: Explore by product moves from a uniform grid to a two-row layout—wide ClickHouse Cloud card with long copy and five in-card links beside three stacked product cards, then a second row of three cards—and the MCP block spacing/border is aligned with the new section pattern.

_site/styles.css: .ch-hero-card hover/dark surfaces, .ch-usecase-divider, and .ch-usecase-arrow theme colors.

Locale home MDX files (es, ja, ko, pt-br, ru, zh) get the shared component/divider/use-case tweaks; their product grids stay the simpler four-column layout with arrows added, not the full English product redesign.

Reviewed by Cursor Bugbot for commit 54ff8d6. Bugbot is set up for automated code reviews on this repo. Configure here.

- Remove use case/product section titles, replace with h2+subtitle style (like MCP section)
- Remove thumbnail images from use case cards; add yellow/black bottom-right arrow
- Add full-width horizontal dividers above/below use case section and below product section
- Add hover states to all HeroCards (dark: #272727 bg / #535353 border; light: #f0f0f0)
- Redesign product section: ClickHouse Cloud (col-span-2 with rich content) + 3 stacked cards, then 3-col row
- Add bottom-right arrows to product cards (ClickStack, Managed Postgres, chDB)
- Fix FullWidthDivider to use getElementById('sidebar') for correct boundary detection
- Consistent spacing: 24px between section subtitle and card grids; mb-0 title/subtitle gap

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@CLAassistant

Copy link
Copy Markdown

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
You have signed the CLA already but the status is still pending? Let us recheck it.

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes using default effort and found 5 potential issues.

Fix All in Cursor

Reviewed by Cursor Bugbot for commit 54ff8d6. Configure here.

Comment thread es/index.mdx
fontWeight: '400',
color: isDark ? '#a1a1aa' : '#6b7280',
minHeight: '3rem'
}}>{description}</span>

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Locale cards show broken images

Medium Severity

Locale HeroCard still renders thumbnail <img> elements whenever icon is absent, even if filename is omitted. Cards such as Observability pass no filename, so browsers request invalid paths like /images/undefined. English index.mdx guards with filename ?, but locale copies were not updated.

Additional Locations (2)
Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit 54ff8d6. Configure here.

Comment thread index.mdx
<h2 className="text-2xl font-semibold text-gray-900 dark:text-zinc-50">
{selected === 'goal' && 'Explore by goal'}
{selected === 'usecase' && 'Explore by use case'}

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Switcher tab missing use case title

Low Severity

When CONTENT_MODE is switcher and the Use case tab is selected, the header h2 renders no text because the selected === 'usecase' label was removed while the tab option remains. Goal and Product titles still render.

Additional Locations (1)
Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit 54ff8d6. Configure here.

Comment thread index.mdx
{ label: "How to build dashboards, alerts, and event-driven features on top", href: "/get-started/use-cases/data-warehousing" },
{ label: "Tips to keep costs low while performance stays high", href: "/operations/best-practices" },
]}
/>

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cloud card href never used

Medium Severity

The ClickHouse Cloud product card passes href but also links, so HeroCard returns a non-link div and ignores href. Unlike neighboring product cards, the main card surface is not clickable—only the bullet links navigate.

Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit 54ff8d6. Configure here.

Comment thread es/index.mdx
color: 'inherit',
position: 'relative',
overflow: 'hidden',
transition: 'background-color 0.12s ease, border-color 0.12s ease'

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Locale cards skip hover styles

Medium Severity

New _site/styles.css hover rules target .ch-hero-card, but locale HeroCard instances use inline cardStyle without that class. Locale homepages will not get the intended light/dark hover backgrounds and borders described in the PR.

Additional Locations (1)
Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit 54ff8d6. Configure here.

Comment thread es/index.mdx
}

return <a style={cardStyle} href={href}>{content}</a>;
return <a style={{ ...cardStyle, ...extraStyle }} href={href} onClick={(e) => { e.preventDefault(); window.location.href = href; }}>{content}</a>;

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Locale links block new tab

Medium Severity

Locale HeroCard link cards now call preventDefault and assign window.location.href on click. Modifier clicks (Ctrl/Cmd) and middle-click no longer open the href in a new tab, unlike standard anchor behavior.

Additional Locations (1)
Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit 54ff8d6. Configure here.

@Blargian Blargian merged commit a045133 into ClickHouse:main Jun 9, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants