TODO 1: Fix Homepage and Hero Layout
Problem
The homepage hero section and overall layout are broken. The HomePage.vue component's CSS grid/flexbox does not properly work within VitePress's .vp-doc container.
Root Causes to Investigate
- HomePage.vue uses
layout: homein index.md frontmatter — this gives a full-width canvas but requires specific VitePress slot usage - The
.homeclass max-width (72rem) may conflict with VitePress's own container constraints - The hero section's absolute positioning and overflow hidden may clip content
- Section padding (5rem) may be excessive or conflicting with VitePress doc padding
- Mobile breakpoints may not align with VitePress's own responsive breakpoints
Files to Modify
.vitepress/theme/components/HomePage.vue— Template structure and inline styles.vitepress/theme/custom.css— All.home,.hero,.section,.model-grid,.eco-grid,.pipelinestylesindex.md— Verify frontmatter useslayout: homecorrectly
Fixes
- Audit the hero section — ensure hero-content is properly centered and visible at all viewport sizes
- Fix section layout — sections should have proper vertical rhythm and horizontal padding
- Verify the model-grid (3-col), pipeline (4-step), and eco-grid (4-col) render correctly on desktop
- Fix mobile responsiveness — all grids should stack to single column below 640px
- Ensure dark mode renders properly for all sections
- Test at: 1440px, 1280px, 1024px, 768px, 375px
Verification
- Run
npm run devand visually inspect the homepage - Verify hero text is visible and centered
- Verify all grids render properly
- Test all breakpoints
- Toggle dark mode