Files
cv/docs/design/specs/v2/spec-v2-homepage-enhancements.md
T
dong.nguyen aa30aed903 feat: homepage enhancements - mobile padding, scroll animations, parallax, background gradient
- Fix mobile padding: add media queries for container and hero-content padding
- Add InView wrapper to Hero and About for scroll-triggered animations
- Add Hero parallax effect: photo moves on scroll, content fades out
- Add section background gradient for smooth visual flow between sections
- Unify section containers to container-wide for title alignment
- Add maxWidth wrappers for text-heavy sections (About, Experience, Contact)
- Replace OpenToWorkBadge with RollingTextLink component
- Update nav router links and profile data
- Add spec docs for v2 homepage enhancements and nav rolling text
2026-10-06 23:42:49 +07:00

6.8 KiB
Raw Blame History

Homepage Enhancements — Section Improvements

Overview

Enhance all homepage sections with three improvements:

  1. Proper mobile padding (text not too close to edges)
  2. Smooth scroll transitions between sections
  3. Unified container width for consistent alignment

1. Mobile Padding Fix

Problem

On small screens (≤768px), text content is too close to the left/right edges due to fixed padding: 0 24px.

Current

/* src/index.css */
.container-wide,
.container-content,
.container-narrow {
  padding: 0 24px; /* fixed, all screen sizes */
}

.section {
  padding: 80px 0;
}

@media (max-width: 768px) {
  .section {
    padding: 48px 0; /* vertical only */
  }
}

Proposed

src/index.css — Add two media queries for container padding:

/* Mobile: ≤768px */
@media (max-width: 768px) {
  .section {
    padding: 48px 0;
  }
  .container-wide,
  .container-content,
  .container-narrow {
    padding-left: 32px;
    padding-right: 32px;
  }
}

/* Medium: 769px–1200px */
@media (min-width: 769px) and (max-width: 1200px) {
  .container-wide,
  .container-content,
  .container-narrow {
    padding-left: 40px;
    padding-right: 40px;
  }
}

src/App.css — Add hero-content padding for medium screens:

/* Medium: 769px–1200px */
@media (min-width: 769px) and (max-width: 1200px) {
  .hero-content {
    padding-left: 16px;
    padding-right: 16px;
  }
}

Breakpoints

Screen size Container padding Hero-content padding
≤768px (mobile) 32px 24px (already set)
769px–1200px (tablet/laptop) 40px 16px (new)
>1200px (desktop) 24px 0

Files

  • src/index.css
  • src/App.css

2. Smooth Scroll Transitions

Problem

  • Hero and About have no scroll animations
  • No scroll-driven parallax effects
  • Section transitions feel abrupt

Current State

Section Animation
Hero Fade-in (opacity only, no scroll trigger)
About No animation
Expertise whileInView fade-in + slide-up
Experience whileInView fade-in + slide-up
Projects whileInView fade-in + slide-up
Contact whileInView fade-in + slide-up

Proposed Changes

2.1 Add InView Wrapper for Hero + About

Hero.tsx: Wrap section with InView to trigger scroll animation:

import { InView } from "@/components/ui/InView"

export function Hero() {
  return (
    <InView>
      <motion.section
        className="hero container-wide"
        // ... existing motion props
      >
        {/* content */}
      </motion.section>
    </InView>
  )
}

About.tsx: Wrap section with InView:

import { InView } from "@/components/ui/InView"

export function About() {
  return (
    <InView>
      <section className="section container-content" aria-labelledby="about-heading">
        {/* content */}
      </section>
    </InView>
  )
}

2.2 Hero Parallax Effect

Add scroll-driven parallax: hero photo moves on scroll, hero content fades out.

import { motion, useScroll, useTransform } from "motion/react"

export function Hero() {
  const { scrollY } = useScroll()
  const y = useTransform(scrollY, [0, 300], [0, -80])
  const opacity = useTransform(scrollY, [0, 200], [1, 0.3])

  return (
    <motion.section className="hero container-wide">
      <motion.div className="hero-content" style={{ opacity }}>
        {/* content */}
      </motion.div>
      <motion.div className="hero-visual" style={{ y }}>
        <img src="/profile-photo.webp" alt="Profile photo" className="hero-photo" />
      </motion.div>
    </motion.section>
  )
}

Effect: Hero photo moves up 80px as user scrolls 300px (parallax). Hero content fades to 30% opacity over first 200px scroll.

2.3 Section Background Gradient

Add subtle gradient transition between sections for smooth visual flow:

/* src/App.css */
.section {
  position: relative;
}

.section::before {
  content: '';
  position: absolute;
  inset: 0;
  background: linear-gradient(
    to bottom,
    transparent 0%,
    var(--bg-primary) 10%,
    var(--bg-primary) 90%,
    transparent 100%
  );
  pointer-events: none;
  z-index: -1;
}

Effect: Creates a smooth fade from section content to background at top/bottom edges (10% gradient zone).

Files

  • src/components/sections/Hero.tsx
  • src/components/sections/About.tsx
  • src/App.css

3. Container Width Alignment

Problem

Sections alternate between two container widths (1200px ↔ 800px) → titles zigzag, hard to follow vertically.

Solution

Unify all sections to use container-wide (1200px) for consistent title alignment. Text-heavy content gets inner maxWidth: '700px' wrapper for readability.

Changes

About.tsx:

// Before
<section className="section container-content">
// After
<section className="section container-wide">

Experience.tsx:

// Before
<motion.section className="section container-content">
// After
<motion.section className="section container-wide">
  {/* Added wrapper */}
  <div style={{ maxWidth: '700px' }}>
    <div className="timeline">...</div>
  </div>
</motion.section>

Contact.tsx:

// Before
<motion.section className="section container-content">
// After
<motion.section className="section container-wide">
  {/* Added wrapper */}
  <div style={{ maxWidth: '700px' }}>
    <div className="contact-links">...</div>
  </div>
</motion.section>

Result

Section Container Content Width
Hero container-wide N/A (grid layout)
About container-wide 700px (inner div)
Expertise container-wide N/A (grid layout)
Experience container-wide 700px (inner div)
Projects container-wide N/A (grid layout)
Contact container-wide 700px (inner div)

All titles now align at the same left position. Grid sections use full width. Text sections constrained to 700px for readability.

Files

  • src/components/sections/About.tsx
  • src/components/sections/Experience.tsx
  • src/components/sections/Contact.tsx

Implementation Order

Step Task Files Est. Time
1 Mobile padding fix src/index.css 5m
2 Add InView to Hero + About Hero.tsx, About.tsx 10m
3 Hero parallax effect Hero.tsx 15m
4 Section background gradient src/App.css 10m
5 Build + verify — 5m

Total: ~45m


Dependencies

  • motion (already installed)
  • No new dependencies

Acceptance Criteria

  1. On mobile (≤768px), text has 32px padding on both sides (not 24px)
  2. Hero has scroll animation (fadeInUp on viewport entry)
  3. About has scroll animation (fadeInUp on viewport entry)
  4. Hero photo has parallax effect on scroll
  5. All sections have scroll reveal animation (fade-in + slide-up)
  6. Build passes (tsc -b && vite build)
  7. No breaking changes to desktop layout