Project details
Notes, phases, and write-up from the project markdown.

jerrykhh profile

Why I built this project

I needed a public home for my work that I owned end to end. Job boards and LinkedIn show a résumé. They do not show how I ship UI, host apps, or write about systems. A personal site fills that gap: introduce who I am, publish projects and posts, and give people a clean way to reach me.

I also treat the site as a standing lab. Each major rewrite was a chance to learn a stack I cared about at the time, while the public URL stayed up. The homepage still links the older builds under the version badges so the history stays visible.

The job of the site never changed. The stack did.

Version history

Newest first.

V4. Next.js (vinext) on Cloudflare Workers

V4 is the current site. It returns to a Next.js App Router shape, runs on Cloudflare Workers through vinext, and keeps blog and project posts as static markdown in git again. The first viewport is a cobalt frost shader hero with glass nav, role line, and Get in Touch / View Projects actions.

Live site: owner.bytesio.net

V4 homepage

V3. Remix

V3 rebuilt the app on Remix (CHANGELOG v3.0.0, May 2025) and pulled blog, project, and profile copy from Notion databases. The UI went minimal and monospace-led: a short intro, Get in Touch, Todo and Releases panels, then blogs. Releases already linked v1 and v2 archives and marked v3 as current.

Notion made content edits easy, but the site then depended on an external store and on a different framework from the Next.js work I do day to day.

Live archive: owner-v3-backup.bytesio.net

V3 homepage

V2. Next.js on Vercel

V2 moved the profile onto Next.js and hosted it on Vercel. Content lived as markdown in the repo. The homepage used a light shadcn-style layout: photo and socials on the left, bio and a pinned todo list on the right, then project cards below.

Live archive: profile-jerrykhh.vercel.app

V2 homepage

V1. Bootstrap (master’s homework)

V1 was a Bootstrap static site I built while studying for my master’s. The archive still loads styles/bootstrap.css and uses a Bootstrap navbar and grid. The page reads like a CV: About Me, experience, education, plus Projects, Blog, and Gallery.

Live archive: owner-v1-backup.bytesio.net

V1 homepage

What V4 is made of

The stack in this repo today:

  • Runtime. vinext plus @vinext/cloudflare and the Cloudflare Vite plugin. vite.config.ts wires vinext and the Worker build. npm run deploy runs vinext-cloudflare deploy.
  • Worker. cloudflare.config.ts names the Worker jerrykhh-profile, uses the vinext/server/fetch-handler entrypoint, and turns on nodejs_compat.
  • UI. React, Tailwind CSS, and shadcn/ui primitives under components/ui. Site chrome uses a liquid-glass nav and a copyright-only footer.
  • Content. content/blog/*.md and content/projects/*.md, loaded with import.meta.glob in lib/content. Profile copy lives in config/profile.ts. Markdown renders through rehype-raw and a sanitized schema that allows YouTube embeds only.
  • CI. A push to development, or a release on main, deploys the Worker through GitHub Actions with npm run deploy and Cloudflare credentials.

Package version is 4.0.0.

Routes and pages

RouteRole
/Hero, experience timeline, skills, education, certifications, featured projects and posts
/project, /project/[slug]Project list and markdown detail
/blog, /blog/[slug]Blog list and markdown detail (external posts open off-site)
/ext/linkShareable contact card

Home and contact share the (cobalt) layout so the hero backdrop stays mounted when you move between those two routes.

Shader hero

The homepage hero is a soft cobalt frost mesh built with the shaders package (MeshGradient, soft CursorRipples, blur). CSS orbs paint first so hydration and home-to-contact navigation do not flash the wrong base color. The WebGPU shader fades in after it is ready. Motion respects prefers-reduced-motion, and ripples stay low-intensity so the effect stays calm.

Light and dark each have their own palette in lib/cobalt-frost.ts. Theme changes animate over about 400 ms instead of cutting hard.

Wallet-style contact

/ext/link is an Apple Wallet style stack of name cards:

  • white personal card
  • active ViuTV card (#0180f5)
  • inactive ViuTV card (same blue with a black overlay)
  • muted Hospital Authority past role

Cards overlap with a peek. A tap brings one card forward. Social links are icon-only (GitHub, LinkedIn, YouTube, Email) with accessible labels. The Email icon goes to /, not mailto:.

SEO and discovery

Shared layout metadata covers:

  • document title Profile | Jerry Kwok on the homepage, and %s | Jerry Kwok elsewhere
  • metadataBase from siteConfig.url
  • canonical URLs, robots allow-all, Open Graph, and Twitter summary cards
  • keywords grounded in the profile copy

app/sitemap.ts lists home, blog, project, contact, and each internal blog or project slug. app/robots.ts points crawlers at that sitemap.

What stayed the same

Across the rewrites I still want the same outcome: introduce Jerry Kwok, show projects and writing, and give a clean way to connect. vinext on Workers with git-backed markdown sits on top of Remix with Notion, Vercel Next.js, and Bootstrap homework. The archives in the version history are the proof trail.

More projects

All projects