Skip to content

README.md

Latest commit

 

History

History
79 lines (56 loc) · 2.97 KB

README.md

File metadata and controls

79 lines (56 loc) · 2.97 KB
Raw

luinbytes.dev

Lu's interactive personal portfolio, built around the living pixel pond version of Signal Desk.

The homepage focuses on Lu's current work at Orchid.ai, selected public projects, and an interactive procedural pond rather than a catalogue of product pages.

The site intentionally has one public route: /. Retired concept and product URLs resolve to the pond-themed 404 instead of preserving stale copies of older portfolios.

The portfolio features HomeBot, rakazo-android, Linux Sonar, bongocat, and cursor-barrier.

Stack

  • Next.js 16 with static export for GitHub Pages
  • React 19 and TypeScript
  • Tailwind CSS v4
  • Framer Motion for interface motion
  • PixiJS and Yuka for the procedural pond ecosystem
  • Lucide React for interface icons

Development

npm install
npm run dev

Open http://localhost:3000.

Run the production checks:

npm run lint
npm run build

The browser suite uses Python Playwright. Install its dependency and Chromium once, then run:

python3 -m pip install -r requirements-test.txt
python3 -m playwright install chromium
npm run test:e2e

npm run test:e2e:setup runs both setup commands. Set E2E_PORT to use a specific isolated test-server port; otherwise the harness allocates one.

Deployment

Pushes to master build and deploy the static export to luinbytes.dev through GitHub Pages.

Social preview

Open Graph and Twitter large-image cards share the checked-in public/share-cards/luinbytes-dev-pond.png (1200 x 630). The versioned filename avoids reusing the old pink card's cached image URL. The old PNG remains available for existing links, but no current metadata references it.

The editable layout is scripts/share-card.html. It preserves the original card's wording exactly and uses the homepage's pond artwork, koi/tabby sprites, colours, Space Grotesk and Space Mono. To regenerate after an intentional design edit, use the browser-test setup above, then:

npm run build
python3 scripts/generate-share-card.py
python3 -m unittest discover -s tests/browser -p '*_test.py' -k ShareCardStaticExportTests -v

The generator embeds fonts from the built site and local images, renders offline, and checks unchanged copy, loaded fonts and a 32px text-safe inset. Review the PNG at full size and at typical embed size before updating the expected SHA-256 in ShareCardStaticExportTests to the generator's printed value. The static-export test rebuilds and checks the metadata, asset dimensions/hash and absence of old image references in exported HTML. Normal Pages builds need no Python, browser, image service or runtime route: Next.js simply exports the checked-in PNG.

Credits

  • Built by Lu
  • Powered by caffeine and spite