Watch

No description

TypeScript 75.5%
Just 11.9%
CSS 9.4%
Dockerfile 2.5%
JavaScript 0.7%

Find a file

Repository files (latest commit first)
Filename	Latest commit message	Latest commit date
Gurbakhshish Singh 08c38c50aa All checks were successful CI / Build, typecheck, lint (push) Successful in 15s Details CI / Publish container image (push) Successful in 3s Details Call the resume projects section Personal projects The heading read "Selected projects" while every entry is a side project, so name the section for what it holds. Re-render public/resume.pdf from the updated copy.		2026-09-15 15:13:29 -04:00
.forgejo/workflows	Cancel superseded main builds but never a tag release	2026-09-11 13:32:05 -04:00
public	Call the resume projects section Personal projects	2026-09-15 15:13:29 -04:00
src	Call the resume projects section Personal projects	2026-09-15 15:13:29 -04:00
.dockerignore	claude generated	2026-09-10 12:37:30 -04:00
.env.example	claude generated	2026-09-10 12:37:30 -04:00
.gitignore	claude generated	2026-09-10 12:37:30 -04:00
AGENTS.md	Add a two-page resume rendered from the site content	2026-09-14 13:43:42 -04:00
CLAUDE.md	claude generated	2026-09-10 12:37:30 -04:00
Dockerfile	claude generated	2026-09-10 12:37:30 -04:00
eslint.config.mjs	claude generated	2026-09-10 12:37:30 -04:00
justfile	Add a two-page resume rendered from the site content	2026-09-14 13:43:42 -04:00
next.config.ts	Harden dev workflow	2026-09-10 23:16:33 -04:00
package.json	0.3.1	2026-09-11 14:20:32 -04:00
pnpm-lock.yaml	Regenerate the lockfile without the stale @pnpm/exe entry	2026-09-11 13:32:05 -04:00
pnpm-workspace.yaml	claude generated	2026-09-10 12:37:30 -04:00
postcss.config.mjs	claude generated	2026-09-10 12:37:30 -04:00
README.md	Add an Off the clock section for out-of-work interests	2026-09-11 14:11:12 -04:00
SPECS.md	Add portfolio homepage handoff spec	2026-09-08 00:39:45 -04:00
tsconfig.json	claude generated	2026-09-10 12:37:30 -04:00

README.md

Portfolio homepage

Single-page portfolio for a software engineer / tech lead. Next.js App Router, TypeScript, Tailwind CSS v4, Motion for the scroll-driven sections, deployed as a Docker container.

Quick start

just install
just dev          # http://localhost:3000

just with no arguments lists every task.

Editing content

All copy lives in typed data files under src/content/ — nothing is fetched at runtime, so a content change is "edit one file, redeploy":

File	What it holds
`src/content/site.ts`	Name, title, tagline, bio, email, SEO defaults
`src/content/experience.ts`	Reverse-chronological roles
`src/content/projects.ts`	Curated project cards
`src/content/interests.ts`	Off-the-clock interests
`src/content/stack.ts`	Tech-stack groups shown in About
`src/content/socials.ts`	Social links

Everything currently in those files is placeholder content. A dev-only badge sits at the bottom of the page until site.isPlaceholderContent is set to false. public/resume.pdf is a placeholder too.

Configuration

NEXT_PUBLIC_SITE_URL is read at build time for canonical URLs, the sitemap, and Open Graph tags — see .env.example. Pass it as a Docker build arg, not a runtime env var.

Docker

NEXT_PUBLIC_SITE_URL=https://your-domain.com just docker-build
just docker-run    # foreground, Ctrl-C to stop
just docker-up     # detached, waits for the healthcheck
just docker-logs   # tail it
just docker-down   # stop and remove it

The image uses Next's standalone output, runs as a non-root user, and exposes port 3000. Reverse proxy, domain, and TLS are handled outside this repo.

Checks

just check   # build, then typecheck and lint

just typecheck needs a build first: Next generates the route types that tsc reads.

Notes

Theme: dark by default, honours prefers-color-scheme on a first visit, toggled from the header. The theme class is written by a blocking inline script, so there is no flash and no layout shift.
Motion: all animation is disabled under prefers-reduced-motion.