- Hero photo: circular shape, object-position center top, transparent background - Hero particles: bigger (6-16px), more visible (opacity 0.8) - Mobile: hide hero photo, transparent hero content, fix text/social link colors - Mobile social links: darker border in light mode - Update spec docs and all section components for v3 UI
28 KiB
Specification - v3 UI Enhancements
firstName: "Dong", lastName: "Nguyen", name: "Dong Nguyen",
Parent:
spec-v2-homepage-enhancements.mdStatus: Draft — not yet implemented
Overview
Enhance the portfolio UI with visual effects inspired by modern developer portfolios. All features use existing dependencies (motion/framer-motion, CSS) — no new packages required.
Implementation Progress
| # | Feature | Status | File(s) |
|---|---|---|---|
| 0 | Prerequisites: types + data | ✅ Done | types/index.ts, data/profile.ts, SectionHeading.tsx, App.css |
| 1 | Section headers (numbered tags) | ✅ Done | SectionHeading.tsx, App.css, pages/sections |
| 2 | Hero: greeting + animated dot | ✅ Done | Hero.tsx, App.css |
| 3 | Hero: gradient name highlight | ✅ Done | Hero.tsx, App.css |
| 4 | Hero: background grid | ✅ Done | Hero.tsx, App.css |
| 5 | Hero: typewriter effect | ✅ Done | Typewriter.tsx, Hero.tsx, App.css |
| 6 | Hero: floating particles | ✅ Done | HeroParticles.tsx, Hero.tsx, App.css |
| 7 | Hero: scroll indicator | ✅ Done | Hero.tsx, App.css |
| 8 | Button: gradient + outline + icon slide | ✅ Done | Button.tsx, App.css |
| 9 | Scroll animations: AnimatedSection | ✅ Done | AnimatedSection.tsx, AboutPage.tsx |
| 10 | Logo: bracket format | ✅ Done | Navigation.tsx, App.css |
| 11 | Build + verify | ✅ Done | type-check + lint pass (build locked by dev server) |
| 12 | Download resume: click outside to close | ✅ Done | DownloadResume.tsx, Hero.tsx, App.css, hooks/useClickOutside.ts |
| 13 | Download resume: FontAwesome-style icon | ✅ Done | DownloadResume.tsx, Hero.tsx |
| 14 | Mobile: hero section responsive fixes | ✅ Done | App.css |
Prerequisites (Type/Data Changes)
Before implementing UI features, update types and data modules:
1. Profile Type — Add firstName, lastName, roles
File: src/types/index.ts
export interface Profile {
name: string
firstName: string // NEW
lastName: string // NEW
title: string
titleEn?: string
tagline: string
taglineEn?: string
bio: string
bioEn?: string
email: string
githubUrl: string
linkedinUrl: string
resumeUrl?: string
currentInterests: string[]
philosophy: PhilosophyPoint[]
}
2. Profile Data — Fill firstName, lastName, roles
File: src/data/profile.ts
export const profile: Profile = {
name: "Dong Nguyen",
firstName: "Dong", // NEW
lastName: "Nguyen", // NEW
title: "Senior Software Engineer",
// ... existing fields unchanged
roles: [ // NEW
"Full-Stack Developer",
"System Architect",
"AI/ML Engineer",
"Open Source Contributor",
],
}
export interface Profile {
name: string;
firstName: string;
lastName: string;
title: string;
titleEn?: string;
tagline: string;
taglineEn?: string;
bio: string;
bioEn?: string;
email: string;
githubUrl: string;
linkedinUrl: string;
resumeUrl?: string;
currentInterests: string[];
roles: string[];
philosophy: PhilosophyPoint[];
}
---
## 1. Hero Section Enhancements
### 1.1 Typewriter Effect
**Effect:** Role titles cycle with typewriter animation (type → pause → delete → next).
**Implementation:**
- New component: `src/components/ui/Typewriter.tsx`
- Uses `useState` + `useEffect` for character cycling
- Cursor blink via CSS `@keyframes`
- Configurable from `profile.roles`
**Props:**
```tsx
interface TypewriterProps {
texts: string[]
typeSpeed?: number // ms per character (default 80)
deleteSpeed?: number // ms per character (default 40)
pauseDuration?: number // ms pause at end (default 2000)
}
CSS — cursor blink:
.typewriter-cursor {
display: inline-block;
width: 2px;
height: 1.1em;
background: var(--accent);
margin-left: 2px;
vertical-align: text-bottom;
animation: blink 1s step-end infinite;
}
@keyframes blink {
0%, 100% { opacity: 1; }
50% { opacity: 0; }
}
Files:
src/components/ui/Typewriter.tsx(new)src/data/profile.ts(addroles)src/types/index.ts(addrolestoProfile)src/index.css(cursor blink animation)
1.2 Greeting with Animated Dot
Effect: "Hi, I'm" with a pulsing green dot before the name.
Implementation:
- Add
<span className="hero-greeting">before hero name - Green dot:
width: 10px; height: 10px; background: var(--success); border-radius: 50%; - Pulse animation:
box-shadowexpands from 0 to 8px and fades
CSS:
.hero-greeting {
display: flex;
align-items: center;
gap: 12px;
margin-bottom: 16px;
font-size: 1.1rem;
color: var(--text-secondary);
}
.greeting-dot {
width: 10px;
height: 10px;
background: var(--success);
border-radius: 50%;
animation: pulse-dot 2s ease-in-out infinite;
}
@keyframes pulse-dot {
0%, 100% { box-shadow: 0 0 0 0 rgba(52, 211, 153, 0.4); }
50% { box-shadow: 0 0 0 8px rgba(52, 211, 153, 0); }
}
Hero.tsx JSX:
<motion.div
initial={{ opacity: 0, y: 10 }}
animate={{ opacity: 1, y: 0 }}
transition={{ duration: 0.4, delay: 0.15 }}
>
<span className="hero-greeting">
<span className="greeting-dot" />
Hi, I'm
</span>
</motion.div>
Files:
src/components/sections/Hero.tsxsrc/index.css
1.3 Background Grid Pattern
Effect: Subtle grid overlay on hero background, faded at edges via radial mask.
Implementation:
- Add
<div className="hero-bg-grid" />as first child of hero section (afterInView) - CSS grid pattern with
linear-gradient, 60px spacing - Mask:
radial-gradient(ellipse at center, black 30%, transparent 70%) - Color:
rgba(96, 165, 250, 0.03)(uses--accent)
CSS:
.hero-bg-grid {
position: absolute;
inset: 0;
background-image:
linear-gradient(rgba(96, 165, 250, 0.03) 1px, transparent 1px),
linear-gradient(90deg, rgba(96, 165, 250, 0.03) 1px, transparent 1px);
background-size: 60px 60px;
mask-image: radial-gradient(ellipse at center, black 30%, transparent 70%);
-webkit-mask-image: radial-gradient(ellipse at center, black 30%, transparent 70%);
pointer-events: none;
}
Files:
src/components/sections/Hero.tsxsrc/App.css
1.4 Floating Particles
Effect: Small dots floating upward in the hero background (30 desktop, 15 mobile).
Implementation:
- New component:
src/components/sections/HeroParticles.tsx - Creates
div.hero-particleelements viauseMemo(stable, no re-renders) - Each particle has random:
leftposition,animationDuration(8–18s),animationDelay(0–10s),width(2–5px) - Animation:
float-particlekeyframes (translateY 100vh → -100px, scale 0 → 1) - Color:
var(--accent)
CSS:
.hero-particles {
position: absolute;
inset: 0;
overflow: hidden;
pointer-events: none;
}
.hero-particle {
position: absolute;
width: 4px;
height: 4px;
background: var(--accent);
border-radius: 50%;
opacity: 0.3;
animation: float-particle linear infinite;
}
@keyframes float-particle {
0% { transform: translateY(100vh) scale(0); opacity: 0; }
10% { opacity: 0.3; }
90% { opacity: 0.3; }
100% { transform: translateY(-100px) scale(1); opacity: 0; }
}
HeroParticles.tsx:
export function HeroParticles() {
const count = typeof window !== 'undefined' && window.innerWidth < 768 ? 15 : 30
const particles = useMemo(() =>
Array.from({ length: count }, (_, i) => ({
id: i,
left: `${Math.random() * 100}%`,
duration: `${Math.random() * 10 + 8}s`,
delay: `${Math.random() * 10}s`,
size: `${Math.random() * 3 + 2}px`,
})),
[count]
)
return (
<div className="hero-particles" aria-hidden="true">
{particles.map(p => (
<div
key={p.id}
className="hero-particle"
style={{
left: p.left,
width: p.size,
height: p.size,
animationDuration: p.duration,
animationDelay: p.delay,
}}
/>
))}
</div>
)
}
Files:
src/components/sections/HeroParticles.tsx(new)src/components/sections/Hero.tsxsrc/index.css
1.5 Scroll Indicator
Effect: Mouse icon with scrolling wheel animation at bottom of hero, "Scroll" label.
Implementation:
- Add
<div className="scroll-indicator">at bottom of hero section - Mouse outline:
24px × 38px, border radius12px - Wheel:
3px × 8px, animatedtranslateYup and down - Float animation on entire indicator
- Centered at
bottom: 40px; left: 50%; transform: translateX(-50%)
CSS:
.scroll-indicator {
position: absolute;
bottom: 40px;
left: 50%;
transform: translateX(-50%);
display: flex;
flex-direction: column;
align-items: center;
gap: 8px;
color: var(--text-muted);
font-size: 0.8rem;
text-transform: uppercase;
letter-spacing: 2px;
animation: float 3s ease-in-out infinite;
text-decoration: none;
pointer-events: none;
}
.scroll-mouse {
width: 24px;
height: 38px;
border: 2px solid var(--border);
border-radius: 12px;
display: flex;
justify-content: center;
padding-top: 8px;
}
.scroll-wheel {
width: 3px;
height: 8px;
background: var(--accent);
border-radius: 2px;
animation: scroll-wheel 2s ease-in-out infinite;
}
@keyframes scroll-wheel {
0%, 100% { transform: translateY(0); opacity: 1; }
50% { transform: translateY(8px); opacity: 0.3; }
}
@keyframes float {
0%, 100% { transform: translateX(-50%) translateY(0); }
50% { transform: translateX(-50%) translateY(-10px); }
}
Hero.tsx JSX:
<div className="scroll-indicator" aria-hidden="true">
<div className="scroll-mouse">
<div className="scroll-wheel" />
</div>
<span>Scroll</span>
</div>
Files:
src/components/sections/Hero.tsxsrc/App.css
1.6 Gradient Name Highlight
Effect: Last word of name uses gradient text fill instead of solid color.
Implementation:
- Use
profile.firstName+profile.lastName(added in prerequisite step) - Wrap
lastNamein<span className="name-highlight"> - CSS:
background: linear-gradient(135deg, var(--accent), #8b5cf6, #a855f7); -webkit-background-clip: text; -webkit-text-fill-color: transparent; background-clip: text;
CSS:
.name-highlight {
background: linear-gradient(135deg, var(--accent), #8b5cf6, #a855f7);
-webkit-background-clip: text;
-webkit-text-fill-color: transparent;
background-clip: text;
}
Hero.tsx JSX:
<motion.h1 ...>
{profile.firstName}{" "}
<span className="name-highlight">{profile.lastName}</span>
</motion.h1>
Files:
src/components/sections/Hero.tsxsrc/App.csssrc/types/index.ts(addfirstName,lastName)src/data/profile.ts(setfirstName,lastName)
2. Button Enhancements
2.1 Gradient Primary Button
Effect: Primary buttons use gradient background with glow shadow.
Implementation:
- Update
.btn-primaryinApp.css:- Background:
linear-gradient(135deg, var(--accent), #8b5cf6, #a855f7) - Box-shadow:
0 4px 20px rgba(96, 165, 250, 0.3)(uses--accentcolor) - Hover:
transform: translateY(-2px), stronger shadow - Border radius:
9999px(pill shape)
- Background:
CSS:
.btn-primary {
background: linear-gradient(135deg, var(--accent), #8b5cf6, #a855f7);
color: #ffffff;
box-shadow: 0 4px 20px rgba(96, 165, 250, 0.3);
border-radius: 9999px;
}
.btn-primary:hover {
transform: translateY(-2px);
box-shadow: 0 8px 30px rgba(96, 165, 250, 0.4);
}
.btn-primary:active {
transform: translateY(0);
box-shadow: 0 2px 10px rgba(96, 165, 250, 0.3);
}
Files:
src/App.css
2.2 Secondary Outline Button
Effect: Secondary buttons become outline style with glow on hover.
Implementation:
- Update
.btn-secondary:- Background:
transparent - Border:
1.5px solid var(--border) - Border radius:
9999px(pill shape) - Hover:
border-color: var(--accent),background: rgba(96, 165, 250, 0.1),transform: translateY(-2px)
- Background:
CSS:
.btn-secondary {
background: transparent;
color: var(--accent);
border: 1.5px solid var(--border);
border-radius: 9999px;
}
.btn-secondary:hover {
border-color: var(--accent);
background: rgba(96, 165, 250, 0.1);
transform: translateY(-2px);
}
.btn-secondary:active {
transform: translateY(0);
}
Files:
src/App.css
2.3 Icon Slide on Hover
Effect: Button icons slide right on hover (primary buttons with icons).
Implementation:
- Add
iconprop toButtoncomponent (optionalReactNode) - Wrap icon in
<span className="btn-icon">when present - CSS:
transition: transform var(--transition-fast) - Hover:
transform: translateX(4px)
Button.tsx changes:
interface ButtonProps extends ComponentPropsWithoutRef<"button"> {
variant?: ButtonVariant
size?: ButtonSize
icon?: ReactNode // NEW
href?: string
download?: boolean
target?: string
}
CSS:
.btn-icon {
display: inline-flex;
margin-left: 6px;
transition: transform var(--transition-fast);
}
.btn-primary:hover .btn-icon,
.btn-secondary:hover .btn-icon {
transform: translateX(4px);
}
Files:
src/components/ui/Button.tsxsrc/App.css
3. Section Headers
3.1 Numbered Tags
Effect: Each section has a numbered tag (e.g., "01 — About", "02 — Expertise").
Implementation:
- Add
tagprop toSectionHeadingcomponent - Render
<span className="section-tag">01 — About</span>before section title - Style: monospace font, accent color, uppercase, letter-spacing
SectionHeading.tsx:
interface SectionHeadingProps {
title: string
subtitle?: string
tag?: string // NEW
id?: string
}
export function SectionHeading({ title, subtitle, tag, id }: SectionHeadingProps) {
return (
<div className="section-heading" id={id}>
{tag && <span className="section-tag">{tag}</span>}
<h2>{title}</h2>
{subtitle && <p>{subtitle}</p>}
</div>
)
}
Usage per section:
| Section | Tag | Component | Current Pattern | Change |
|---|---|---|---|---|
| About | "01 — About" |
AboutPage.tsx, About.tsx |
SectionHeading |
Add tag prop |
| Expertise | "02 — Expertise" |
Expertise.tsx, AboutPage.tsx |
SectionHeading |
Add tag prop |
| Experience | "03 — Experience" |
ExperiencePage.tsx, Experience.tsx |
<h2> inline |
Replace with SectionHeading |
| Projects | "04 — Projects" |
ProjectsListPage.tsx, Projects.tsx |
No heading / <h2> inline |
Add SectionHeading |
| Engineering | "05 — Engineering" |
EngineeringPage.tsx |
<h2> inline |
Replace with SectionHeading |
| Contact | "06 — Contact" |
ContactPage.tsx, Contact.tsx |
SectionHeading |
Add tag prop |
CSS:
.section-tag {
display: block;
font-family: var(--mono);
font-size: 0.85rem;
color: var(--accent);
text-transform: uppercase;
letter-spacing: 2px;
margin-bottom: 8px;
}
Files:
src/components/ui/SectionHeading.tsx(addtagprop)src/App.css(add.section-tagstyles)src/pages/AboutPage.tsx(addtagto 2xSectionHeading)src/components/sections/About.tsx(addtagtoSectionHeading)src/components/sections/Expertise.tsx(addtagtoSectionHeading)src/pages/ExperiencePage.tsx(replace<h2>withSectionHeading)src/components/sections/Experience.tsx(replace<h2>withSectionHeading)src/pages/ProjectsListPage.tsx(addSectionHeadingbefore grid)src/components/sections/Projects.tsx(replace<h2>withSectionHeading)src/pages/EngineeringPage.tsx(replace<h2>withSectionHeading)src/pages/ContactPage.tsx(addtagtoSectionHeading)src/components/sections/Contact.tsx(addtagtoSectionHeading)
4. Scroll Animations
4.1 Unified Animation Wrapper
Effect: Sections animate in on scroll with configurable direction and delay.
Current state:
- Expertise, Experience, Projects, Contact:
whileInViewfade-in + slide-up (viamotion.section) - Hero:
InView+ initial fade-in (no scroll trigger for entrance) - About: no animation
Implementation:
- New component:
src/components/ui/AnimatedSection.tsx - Wraps children in
motion.divwithwhileInViewanimation - Accepts
directionprop:'up' | 'right' | 'left' - Accepts
delayprop for staggered children - Uses
InViewfor scroll-triggered rendering
Props:
interface AnimatedSectionProps {
direction?: 'up' | 'right' | 'left'
delay?: number
children: ReactNode
}
AnimatedSection.tsx:
import { motion } from "motion/react"
import { InView } from "@/components/ui/InView"
const directions = {
up: { y: [40, 0], opacity: [0, 1] },
right: { x: [-40, 0], opacity: [0, 1] },
left: { x: [40, 0], opacity: [0, 1] },
}
export function AnimatedSection({
direction = 'up',
delay = 0,
children,
}: AnimatedSectionProps) {
const { y, opacity } = directions[direction]
return (
<InView>
<motion.div
initial={{ y, opacity }}
whileInView={{ y: 0, opacity: 1 }}
viewport={{ once: true, margin: "0px 0px -50px 0px" }}
transition={{ duration: 0.6, delay, ease: [0.25, 0.1, 0.25, 1] }}
>
{children}
</motion.div>
</InView>
)
}
Usage:
// AboutPage.tsx
<AnimatedSection>
<section className="section container-content" ...>
{/* content */}
</section>
</AnimatedSection>
// Expertise.tsx (replace existing motion.section)
<AnimatedSection direction="up" delay={0.1}>
<section className="section container-wide" ...>
{/* content */}
</section>
</AnimatedSection>
Files:
src/components/ui/AnimatedSection.tsx(new)src/pages/AboutPage.tsx(wrap with AnimatedSection)src/components/sections/Expertise.tsx(replace motion.section)src/pages/ExperiencePage.tsx(replace motion.section)src/pages/ProjectsListPage.tsx(replace motion.section)src/pages/ContactPage.tsx(replace motion.section)
5. Footer Enhancements
5.1 Back to Top Button
Effect: Floating button appears after scrolling, smoothly scrolls to top.
Implementation:
- Add
scrollYstate inFooter.tsxviauseEffect+window.addEventListener('scroll', ...) - Visible when
scrollY > 400px - Position:
fixed,bottom: 24px,right: 24px - Icon: upward arrow SVG
- Click:
window.scrollTo({ top: 0, behavior: 'smooth' })
CSS:
.back-to-top {
position: fixed;
bottom: 24px;
right: 24px;
width: 48px;
height: 48px;
background: var(--accent);
color: white;
border: none;
border-radius: 50%;
display: flex;
align-items: center;
justify-content: center;
cursor: pointer;
opacity: 0;
transform: translateY(20px);
transition: opacity var(--transition-base), transform var(--transition-base), background var(--transition-fast);
z-index: 100;
pointer-events: none;
}
.back-to-top.visible {
opacity: 1;
transform: translateY(0);
pointer-events: auto;
}
.back-to-top:hover {
background: var(--accent-hover);
}
.back-to-top svg {
width: 20px;
height: 20px;
}
Footer.tsx changes:
export function Footer() {
const year = new Date().getFullYear()
const [visible, setVisible] = useState(false)
useEffect(() => {
const handleScroll = () => setVisible(window.scrollY > 400)
window.addEventListener('scroll', handleScroll, { passive: true })
return () => window.removeEventListener('scroll', handleScroll)
}, [])
return (
<>
<footer className="footer" role="contentinfo">
{/* existing footer content */}
</footer>
<button
className={`back-to-top ${visible ? 'visible' : ''}`}
onClick={() => window.scrollTo({ top: 0, behavior: 'smooth' })}
aria-label="Back to top"
>
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2">
<path d="M18 15l-6-6-6 6" />
</svg>
</button>
</>
)
}
Files:
src/components/layout/Footer.tsxsrc/App.css
6. Logo Enhancement
6.1 Bracket Logo
Effect: Navigation logo uses {Name} format with bracket styling.
Implementation:
- Update logo in
Navigation.tsx:<span className="logo-bracket">{</span><span className="logo-text">{profile.firstName} {profile.lastName}</span><span className="logo-bracket">}</span>
- Bracket: accent color, monospace font
- Text: white, bold
CSS:
.logo-bracket {
color: var(--accent);
font-family: var(--mono);
font-size: 1.2rem;
font-weight: 700;
}
.logo-text {
color: var(--text-primary);
font-weight: 700;
font-size: 1.1rem;
}
Navigation.tsx changes:
<Link to="/" className="nav-logo">
<span className="logo-bracket">{</span>
<span className="logo-text">
{profile.firstName} {profile.lastName}
</span>
<span className="logo-bracket">}</span>
</Link>
Files:
src/components/layout/Navigation.tsxsrc/App.csssrc/data/profile.ts(importprofile)
7. Download Resume Dropdown — Click Outside to Close
7.1 Controlled Dropdown with Outside Click Close
Effect: Replace HTML <details> toggle with controlled React state. Click outside the dropdown to close (instead of clicking the button again).
Current state:
DownloadDropdown(Contact page) andHeroDownloadDropdown(Hero section) use<details>element- Toggles open/close on summary click
- Native
<details>behavior — no external click handling
Implementation:
- Replace
<details>with controlled<div>+ React state - Add
mousedown+touchstartlistener ondocumentwhen dropdown is open - Click outside the dropdown ref →
setOpen(false) - Replace
<summary>with<button>(proper accessibility) - Add
.openclass to options container when open (CSS controls visibility) - Add
.openclass to summary for chevron rotation
DownloadResume.tsx changes:
import { useState, useRef, useEffect } from 'react'
function DownloadDropdown() {
const [open, setOpen] = useState(false)
const ref = useRef<HTMLDivElement>(null)
useEffect(() => {
if (!open) return
const listener = (e: MouseEvent | TouchEvent) => {
if (ref.current && !ref.current.contains(e.target as Node)) {
setOpen(false)
}
}
document.addEventListener('mousedown', listener)
document.addEventListener('touchstart', listener)
return () => {
document.removeEventListener('mousedown', listener)
document.removeEventListener('touchstart', listener)
}
}, [open])
return (
<div ref={ref} className="download-resume-dropdown">
<button
className="download-resume-summary"
onClick={() => setOpen(!open)}
type="button"
>
{/* icon + label + chevron */}
</button>
<div className={`download-resume-options ${open ? 'open' : ''}`}>
{/* language options */}
</div>
</div>
)
}
Hero.tsx changes: Same pattern for HeroDownloadDropdown.
CSS changes (App.css):
/* Hide options by default, show when .open class present */
.download-resume-dropdown .download-resume-options {
display: none;
}
.download-resume-dropdown .download-resume-options.open {
display: block;
}
/* Rotate chevron when summary has .open class */
.download-resume-dropdown .download-resume-summary.open .chevron {
transform: rotate(180deg);
}
Removed: .download-resume-dropdown[open] pseudo-class selectors (no longer needed).
Files:
src/components/sections/DownloadResume.tsx(controlled dropdown)src/components/sections/Hero.tsx(controlled dropdown)src/App.css(CSS for.openclass visibility)src/hooks/useClickOutside.ts(reusable hook, created but logic inlined)
8. Mobile Responsive Fixes
8.1 Download Resume Icon — FontAwesome Style
Effect: Replace Material Design download icon with FontAwesome-style outline icon (document + arrow).
Implementation:
- Update SVG path in
DownloadResume.tsxandHero.tsx - New icon: FontAwesome download style with document outline and downward arrow
Files:
src/components/sections/DownloadResume.tsxsrc/components/sections/Hero.tsx
8.2 Hero Section — Mobile Layout
Issues fixed:
- Hero height using
100vhon mobile includes browser UI (address bar), causing content to be clipped - Scroll indicator positioned outside visible viewport due to overflow clipping
- Social links not centered on mobile
- Hero text (greeting, title, tagline, social links) invisible in light mode on dark overlay
Implementation:
Hero height:
@media (max-width: 768px) {
.hero {
min-height: 100dvh; /* Changed from 100vh */
overflow: hidden;
}
}
Scroll indicator positioning:
@media (max-width: 768px) {
.scroll-indicator {
position: absolute;
bottom: 20px; /* Changed from 40px */
left: 50%;
transform: translateX(-50%);
z-index: 10; /* Above hero-content (z-index: 1) */
color: #ffffff; /* White text on dark overlay */
}
.scroll-mouse {
border-color: rgba(255, 255, 255, 0.5);
}
.hero .scroll-indicator span {
display: block !important;
color: #ffffff !important;
opacity: 1 !important;
}
}
Social links centering:
@media (max-width: 768px) {
.social-links {
justify-content: center;
}
.social-link {
color: #ffffff; /* White on dark overlay */
}
}
Hero text colors (light/dark mode consistency):
@media (max-width: 768px) {
.hero-name {
color: #ffffff;
}
.hero-title,
.hero-tagline,
.hero-greeting {
color: #e0e0e0; /* Same color for title, tagline, greeting */
}
}
Files:
src/App.css(mobile media query overrides)
Implementation Order
| Step | Feature | Dependencies | Est. Time |
|---|---|---|---|
| 0 | Prerequisites: types + data | — | 10m |
| 1 | Section headers (numbered tags) | Step 0 | 15m |
| 2 | Hero: greeting + animated dot | — | 10m |
| 3 | Hero: gradient name highlight | Step 0 | 5m |
| 4 | Hero: background grid | — | 10m |
| 5 | Hero: typewriter effect | Step 0 | 20m |
| 6 | Hero: floating particles | — | 15m |
| 7 | Hero: scroll indicator | — | 10m |
| 8 | Button: gradient + outline + icon slide | — | 10m |
| 9 | Scroll animations: AnimatedSection | — | 20m |
| 10 | Logo: bracket format | Step 0 | 5m |
| 11 | Build + verify | All | 10m |
| 12 | Download resume: click outside to close | — | 15m |
| 13 | Download resume: FontAwesome-style icon | — | 5m |
| 14 | Mobile: hero section responsive fixes | — | 15m |
Total: ~4h 35m
Dependencies
motion(already installed viaframer-motion)- No new packages required
Acceptance Criteria
- Typewriter cycles through
profile.roleswith cursor blink - Greeting dot pulses continuously
- Background grid visible on hero, faded at edges
- Particles float upward, 30 desktop / 15 mobile
- Scroll indicator with mouse animation at hero bottom
- Name uses gradient text fill (lastName only)
- Primary buttons: gradient bg, glow shadow, pill shape, lift on hover
- Secondary buttons: outline style, glow on hover, lift
- Button icons slide right on hover
- Section headers have numbered tags
- All sections animate in on scroll with direction control
- Logo:
{FirstName LastName}bracket format - Download resume dropdown: click outside to close (instead of toggle on button click)
- No new dependencies added
- All features work in dark/light themes
- No breaking changes to existing layout
pnpm buildpasses (type-check + build)pnpm lintpasses- Download resume icon uses FontAwesome-style SVG
- Hero section uses
100dvhon mobile (no clipping) - Scroll indicator visible and centered on mobile
- Social links centered on mobile
- All hero text (greeting, title, tagline, social links) visible in both dark/light modes on mobile