$ cd ~/projects
Portfolio
// how it works
CLI-themed static portfolio. Next.js (App Router) static export, deployed on Cloudflare Pages.
All project data is driven by a single config file — no hardcoded project entries.
## Architecture
```
config/projects.json <- THE source of truth (status, paths, repo URLs)
|
v
scripts/build-projects.mjs <- reads config + local READMEs + GitHub API
|
v
src/data/projects.json <- generated: project metadata
src/data/project-readmes.json <- generated: rendered README HTML
|
v
next build <- reads generated files, out
CLI-themed static portfolio. Next.js (App Router) static export, deployed on Cloudflare Pages. All project data is driven by a single config file — no hardcoded project entries.
Architecture
config/projects.json <- THE source of truth (status, paths, repo URLs)
|
v
scripts/build-projects.mjs <- reads config + local READMEs + GitHub API
|
v
src/data/projects.json <- generated: project metadata
src/data/project-readmes.json <- generated: rendered README HTML
|
v
next build <- reads generated files, outputs static HTML
Commands
npm run dev # local dev
npm run prebuild # regenerate project data from config
npm run build # prebuild + static export to out/
npm run sync # build with GitHub API (--sync flag, needs GITHUB_TOKEN)
Adding a project
- Add an entry to
config/projects.json:
{
"slug": "my-project",
"localPath": "/path/to/project",
"repo": "owner/repo", // optional, for GitHub sync
"status": "development", // featured | deployed | development | experiment
"liveUrl": null,
"stackOverride": ["React", "Node.js"] // optional, overrides auto-detection
}
- Run
npm run prebuild— it reads the README and generates the data files - Run
npm run build— detail page appears at/projects/my-project
Status values
- featured — top projects, largest cards, ranked by
featuredRank - deployed — live at a URL, shown with green dot
- development — work in progress, honest framing
- experiment — smaller builds, collapsible section
Nightly sync
.github/workflows/nightly-project-sync.yml runs at 15:30 UTC daily with --sync flag,
fetching latest pushed_at timestamps and descriptions from GitHub. Local README content
always wins over GitHub descriptions for tagline/copy.
Cloudflare Pages
- Build command:
npm run build - Output directory:
out - Custom domain:
builtbyvaibhav.bylance.in
Placeholders to replace
public/og-image.png— placeholder OG imagepublic/resume.pdf— placeholder v0.1
Full spec: see ../portfolio-spec.md.
// stack
Next.jsTypeScriptGitHub ActionsCloudflare Pages