A Next.js, React, TypeScript, and CSS Modules portfolio exported statically for GitHub Pages.
The site is one centered, compact notebook scrapbook portfolio. Projects, open-source work, education, practical details, and contact live on the same ivory sheet over a static CSS patterned background. It uses the supplied paper texture, identity artwork, small cursors, and fonts, with no Work/About/Resume navigation. The initial launch intentionally does not publish a résumé PDF.
Use Node.js 24 LTS (nvm use if you use nvm), then:
npm ci
npm run devOpen http://localhost:3000. Manrope is self-hosted from the Fontsource package; the local design uses the supplied Super Adorable and Papernotes fonts for expressive type. Review the font notes before publishing or pushing font files to a public repository. Metadata uses SITE_URL when set; no production domain is invented for local builds.
npm run lint
npm run typecheck
npm run build
npm run verify
npm run previewThe export verifier checks the one-page route, custom 404, HTML and CSS asset paths, remaining audio and SVGs, unchanged identity image, and confirms that the approved résumé download exports unchanged.
preview serves out/ at port 3000 with real 404 responses and no SPA fallback. It is a local verification utility, not a production server. Set PORT to change its port.
To test project-site deployment, build, verify, and preview with the same NEXT_PUBLIC_BASE_PATH=/portfolio environment variable. Root deployments leave that variable empty. See .env.example for build configuration. SITE_URL must be the complete deployed site URL, including its repository prefix when applicable.
- Push the project to the intended GitHub repository.
- In repository Settings → Pages, choose GitHub Actions as the publishing source.
- Run the included workflow on the default branch, or push a change there. Other branches and pull requests build and validate without publishing.
- The workflow derives the base path and canonical site URL from the actual repository. It publishes
out/after all checks pass.
For a custom domain, configure it and its DNS in GitHub Pages, then set repository variable PAGES_CUSTOM_DOMAIN to the hostname only. The workflow uses a root base path and includes a CNAME file. Public-repository Pages hosting does not require student-plan approval.
Application facts are maintained in src/lib/content.ts and rendered by src/components/ResumeSections.tsx. The visible projects are Eiga, Feedback, and clockwork; Open Source Work links to the supplied Node.js PR. Unconfirmed descriptions, Kiroku, and employment claims remain omitted. See asset provenance and font decisions before public publication.
ESLint is pinned to the 9.x major because the React plugin bundled with the current Next.js lint configuration fails on ESLint 10. Update them together when that plugin supports the new API. Node.js 24 LTS is selected for CI; local verification in this workspace used Node.js 26.8.1.
On codex/static-background, the cream grid, rust checks, teal waves, and mustard stripes are purely decorative CSS layers. The draggable scraps and entire Easter egg have been removed, together with their unused artwork and jackpot audio. The notebook page remains, with the identity image in a plain CSS frame. Paper cutouts, tape overlays, and the 404 cat are removed. The animated cat with a ball is restored beside the notebook, hidden on narrow screens and for reduced motion. Only the font-change sounds remain.
Validation and production publication were authorized on September 30. Lint, typecheck, root production build, export verification, and desktop/mobile browser checks passed; see the validation record for details and limitations. The discarded minimal redesign is backed up at /tmp/portfolio-minimal-design-20260930.tar.gz in this workspace.