Skip to content

About

An interactive React 18 portfolio featuring AI-powered career assistance, dynamic project showcases with live previews, smooth Framer Motion animations, adaptive theming, mobile-optimized navigation, and SEO-enhanced architecture for professional presentation

Resources

Stars

89 stars

Watchers

9 watching

Forks

Repository files navigation

Yuelin Liu — Portfolio

A personal software-engineering portfolio published at www.liuyuelin.dev. The site uses a static-first Next.js architecture and does not require a runtime backend for the portfolio itself.

Current Portfolio

The mounted homepage is ordered as follows:

  1. Hero — who I am: name, role, one sentence about the kind of work, the range in a paragraph, and two actions (browse the work, download the résumé), beside the photograph from the field
  2. Work — an overview first: four cards, each a different kind of work (Flickside as the mobile product and lead, ByteCroniX as work experience, Marshal as workflow design, MoneyGuard as a calculation boundary). The ByteCroniX account follows in full, then one list of further evidence and a plain-facts strip (roles, stack, what I am open to)
  3. Further out — a sideways strip of four photographs, one per place
  4. Contact

The hero button, the Work link and every case study's "Back to all work" land on the overview. Depth lives on the case-study pages: Flickside's flow, limit and website on /work/flickside/, and the interactive figures for Marshal and MoneyGuard on theirs.

Day is the default light; the switch in the masthead changes the whole site, case studies included, to night. On a phone the navigation sits in a bar at the bottom of the screen.

The current static export emits these case-study routes from source data:

  • /work/flickside/
  • /work/marshal/
  • /work/job-search-dispatch/
  • /work/dsh-conversation-exporter/
  • /work/moneyguard/
  • /work/melbourne-ultimate/
  • /work/alex/

Architecture

  • Next.js 16 App Router with React 19.
  • Fully static production output through output: "export", written to out/ with trailing-slash routes.
  • Route-owned metadata for the homepage and each case study.
  • Static robots.txt and sitemap.xml generated by app/robots.js and app/sitemap.js.
  • Static case-study pages generated from approved source data.
  • No API route, server-side rendering runtime, ISR, middleware or application backend is required to serve the portfolio.

app/page.jsx owns the homepage route and metadata. src/App.jsx is the client boundary for navigation, motion, contexts and local interactions.

Content Model

Current public content is maintained in these authoritative files:

  • src/constants/constants.js — hero, at-a-glance strip, toolbox, Further out and Contact content.
  • src/constants/work.js — the work overview cards, the ByteCroniX account, the evidence list and figure copy.
  • src/constants/caseStudies.js — case-study routes, metadata and page copy.

Public claims are kept evidence-bounded. Changes should preserve the distinctions between verified work, owner-attested facts, learning material and stated limitations.

Case Studies

app/work/[slug]/page.jsx is the reusable static case-study renderer. CASE_STUDIES in src/constants/caseStudies.js supplies the approved slugs and content; generateStaticParams() emits one route per slug, dynamicParams = false prevents unknown slugs from generating content, and each page owns its metadata.

Homepage cards and evidence rows link to case studies through caseStudyHref. The sitemap derives the same canonical route set from CASE_STUDIES.

Resume

The portfolio serves a static PDF from:

public/resume/yuelin-liu-resume.pdf

Development

Install dependencies:

npm ci

Run the development server:

npm run dev

Run lint:

npm run lint

Build the static export:

npm run build

Verify the generated static output after building:

npm run verify:static

Install Chromium once for the browser checks:

npx playwright install chromium

Run the complete pre-release gate:

npm run verify

Serve out/ locally on port 4173:

npm run preview

Verification

scripts/verify-static-output.mjs checks the built files under out/. At a high level, it protects:

  • meaningful prerendered homepage and case-study HTML;
  • the exact approved case-study route set;
  • route metadata, canonical URLs, sitemap and robots output;
  • required public assets, including the resume PDF and social/project images;
  • evidence-bounded public wording, attribution and stated limitations.

tests/recruiter-journeys.spec.js drives the production static export in Chromium. It checks direct loads with JavaScript disabled, navigation and case-study return paths, the résumé and outbound-link boundary, contact-form validation and mailto construction, keyboard order and focus visibility, reduced motion, supported viewport widths, horizontal overflow, and portfolio-owned browser errors. External sites and operating-system mail clients are deliberately not controlled; the gate verifies the outbound action instead.

npm run verify runs lint, the production build, static-output verification, and the recruiter-journey browser suite. GitHub Actions runs the same command for pull requests and pushes to main.

Deployment

next build writes the static site to out/. vercel.json configures Vercel to publish that directory, so deployment serves generated files without a portfolio application server.

Repository Guidance

Before changing the repository, read:

  • AGENTS.md

Content changes must preserve evidence fidelity and avoid speculative claims.

License and Reuse

This repository does not currently include a LICENSE file. It is a public personal portfolio repository; this README does not grant reuse rights.

About

An interactive React 18 portfolio featuring AI-powered career assistance, dynamic project showcases with live previews, smooth Framer Motion animations, adaptive theming, mobile-optimized navigation, and SEO-enhanced architecture for professional presentation

Resources

Stars

89 stars

Watchers

9 watching

Forks

Releases

Packages

Used by

Contributors

Languages