- 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
6.8 KiB
Specification - Rolling Text Navigation Links
Document:
spec-v2-nav-rolling-text.mdVersion: 0.1.0 Parent:spec-ui-navigation.mdPriority: P2 Estimate: ~45 minutes
Requirement
Apply the rolling text button animation pattern (from docs/sample-code/rolling-text-button.md) to navigation menu links in Navigation.tsx. On hover/focus, the link text slides out downward while an identical copy slides in from below.
Animation Design
Pattern
Based on the sample code's dual-span approach:
| Element | Variant | Initial | Hover/Focus |
|---|---|---|---|
Outgoing <motion.span> |
rest → active |
translateY(0%) |
translateY(100%) |
Incoming <motion.span> |
rest → active |
translateY(-100%) |
translateY(0%) |
Timing
| Property | Value |
|---|---|
| Duration | 0.3s |
| Easing | [0.338, 0.015, 0.395, 0.959] (custom cubic-bezier, snappy ease-out) |
| Trigger | onHoverStart/onHoverEnd + onFocus/onBlur |
Accessibility
useReducedMotionfrommotion/reactdisables animation when user prefers reduced motion- When reduced motion is active, text swaps instantly with no animation
aria-hidden="true"on the animated label spans (text is still read by screen reader via parent<a>)
Component Architecture
RollingTextLink — new component
Extracted as a reusable component in src/components/ui/RollingTextLink.tsx:
import { motion, useReducedMotion } from "motion/react"
import { useRef, useState } from "react"
interface RollingTextLinkProps {
to: string
children: React.ReactNode
className?: string
isActive?: boolean
}
const outgoingVariants = {
rest: { transform: "translateY(0%)" },
active: { transform: "translateY(100%)" },
}
const incomingVariants = {
rest: { transform: "translateY(-100%)" },
active: { transform: "translateY(0%)" },
}
const transition = {
duration: 0.3,
ease: [0.338, 0.015, 0.395, 0.959] as const,
}
export function RollingTextLink({ to, children, className, isActive }: RollingTextLinkProps) {
const reduceMotion = useReducedMotion()
const [active, setActive] = useState(false)
const activeRef = useRef(false)
const animating = useRef(false)
const pendingRequest = useRef<boolean | null>(null)
const hovered = useRef(false)
const focused = useRef(false)
const updateActive = (next: boolean) => {
activeRef.current = next
setActive(next)
}
const requestActive = (next: boolean) => {
if (reduceMotion) return
if (next === activeRef.current) {
pendingRequest.current = null
return
}
if (animating.current) {
pendingRequest.current = next
return
}
animating.current = true
updateActive(next)
}
const completeAnimation = () => {
if (!animating.current) return
animating.current = false
if (pendingRequest.current !== null && pendingRequest.current !== activeRef.current) {
const next = pendingRequest.current
pendingRequest.current = null
animating.current = true
updateActive(next)
} else {
pendingRequest.current = null
}
}
return (
<a
href={to}
className={className}
aria-label={typeof children === 'string' ? children : undefined}
onHoverStart={() => {
hovered.current = true
requestActive(true)
}}
onHoverEnd={() => {
hovered.current = false
requestActive(focused.current)
}}
onFocus={() => {
focused.current = true
requestActive(true)
}}
onBlur={() => {
focused.current = false
requestActive(hovered.current)
}}
>
<span style={{ position: "relative", display: "inline-block", overflow: "hidden" }}>
<motion.span
style={{ display: "block", whiteSpace: "nowrap" }}
variants={outgoingVariants}
initial="rest"
animate={active ? "active" : "rest"}
onAnimationComplete={completeAnimation}
transition={transition}
>
{children}
</motion.span>
<motion.span
style={{
display: "block",
whiteSpace: "nowrap",
position: "absolute",
inset: 0,
}}
variants={incomingVariants}
initial="rest"
animate={active ? "active" : "rest"}
transition={transition}
>
{children}
</motion.span>
</span>
</a>
)
}
Integration Points
Desktop nav links (<NavLink> → <RollingTextLink>)
Replace in src/components/layout/Navigation.tsx:
// Before
<NavLink to={item.path} className={({ isActive }) => isActive ? 'nav-link active' : 'nav-link'}>
{item.label}
</NavLink>
// After
<RollingTextLink
to={item.path}
className={({ isActive }) => isActive ? 'nav-link active' : 'nav-link'}
>
{item.label}
</RollingTextLink>
Mobile nav links
Same replacement in the mobile menu section:
// Before
<NavLink
to={item.path}
className={({ isActive }) => isActive ? 'mobile-menu-link active' : 'mobile-menu-link'}
onClick={() => setMobileOpen(false)}
>
{item.label}
</NavLink>
// After
<RollingTextLink
to={item.path}
className={({ isActive }) => isActive ? 'mobile-menu-link active' : 'mobile-menu-link'}
onClick={() => setMobileOpen(false)}
>
{item.label}
</RollingTextLink>
CSS — no changes required
The rolling text uses inline styles for the animation container. Existing .nav-link and .mobile-menu-link classes remain unchanged — color, hover color, active state, and underline all apply to the parent <a> as before.
Edge Cases
| Scenario | Behavior |
|---|---|
| Rapid hover enter/leave | pendingRequest queue ensures animation completes current frame before starting next |
prefers-reduced-motion |
Animation disabled; text swaps instantly |
| Active link (current page) | Text still rolls on hover; active class preserved |
| Mobile menu open | Touch triggers onHoverStart/onHoverEnd equivalents via onFocus/onBlur |
| Screen reader | Parent <a> still contains text node; motion spans have aria-hidden |
Acceptance
RollingTextLinkcomponent created insrc/components/ui/RollingTextLink.tsx- Desktop nav links use
RollingTextLinkwrapping label text - Mobile nav links use
RollingTextLinkwrapping label text - Text slides out downward on hover, new text slides in from below
- Transition: 0.3s, cubic-bezier
[0.338, 0.015, 0.395, 0.959] useReducedMotionrespected — no animation when preferred- Rapid hover transitions handled without jank (queue system)
- Active link state preserved (color + underline)
- Hover color transition still works (parent
<a>handlescolor) - Builds clean (
pnpm build) with no type errors - Existing
.nav-link/.mobile-menu-linkCSS classes unchanged