Zhiyuan Song
← Home

Portfolio Website Template

Two narrative tracks—job seeker vs researcher: the first foregrounds projects and experience; the second foregrounds publications and teaching. Swap sections, navigation, and visuals (e.g. gradient backdrops), skill SVGs, and timelines with minimal code churn. README plus onboarding copy; Vercel one-click deploy.

The repository is maintained in public; directory layout and config keys follow the current GitHub tree (the old clone name personal-website-temp in README is deprecated—use the repository name below).

Core features

  • Dual templates: job seeker (experience + projects) vs researcher (research + teaching)
  • Guided onboarding: interactive notes and docs to lower first-time setup cost
  • About: configurable background and goals
  • Skills grid: SVG icons + labels
  • Education timeline: degrees or notable coursework
  • Gallery block: photos and highlights
  • Highly customizable: reorder sections, nav, theme colors
  • Deploy: Vercel flow and CLI notes

Tech stack

  • Next.js, React, TypeScript, Tailwind CSS
  • Hosting: Vercel

Adoption & feedback (README figures)

  • 100+ template downloads (self-reported, not a hard GitHub API count)
  • ~95% deploy success (self-reported)
  • ~4.9 / 5 satisfaction (self-reported)

GitHub shows ~10 stars and ~7 forks (changes over time—see the repo page).

Quick start

git clone https://github.com/songzhiyuan98/personal-website-template.git
cd personal-website-template
npm install
  1. Open primary pages under app (e.g. page.tsx, follow the repo) to skim structure
  2. Pick job seeker vs researcher direction; adjust section ids, titles, and copy
  3. Fill in profile, skills, and project / paper highlights
  4. Local preview: npm run devhttp://localhost:3000
  5. Production: install Vercel CLI then vercel, or connect the GitHub repo in the Vercel dashboard

Contributing & license

Pull requests and issues are welcome; suggestions can also live in repo discussions.

License: MIT.