Projex

[active](hybrid)

Project showcase framework for personal sites - Show Everything You Ship.

Pre-built project cards with automatic data fetching from GitHub, npm, and Product Hunt

stats:

github:

0stars

0forks

npm:

217downloads

1.1.4version

stack:

TypeScript

React

Vitest

ESLint

links:

github npm docs

background:

It started with a simple question: how do I showcase my projects on my personal site in a structured way? I asked AI, did some research, and kept getting the same answer - Most developers just build a custom solution. That struck me as strange. If everyone building a personal site needs a project showcase, why is everyone building the same thing from scratch? That gap felt like an opportunity.

why:

Projex is my attempt to solve that problem once and for all. A shadcn-style component library that gives developers pre-built project cards with automatic data fetching from GitHub, npm, and Product Hunt. But it was also about more than the problem I was solving. I wanted to build something that other people could actually use. My first real OSS project. One small step toward building something with my name on it.

struggles:

[challenge]OIDC trusted publishing took several failed attempts before working it out

[challenge]VitePress on Vercel silently 404s if your output directory or routing config is even slightly wrong

[challenge]Started with a split CLI/core architecture, merged it back — premature separation added complexity

[learning]OIDC trusted publishing is worth the setup pain — no secrets to rotate, no tokens to leak

[learning]Architecture decisions made on day one are expensive to undo. Bias toward simplicity when possible

timeline:

2026-02-21Monorepo scaffolded with pnpm workspaces, GitHub API integration wired up

2026-02-22Added NPM registry and Product Hunt as data sources alongside GitHub

2026-02-23VitePress docs site live with interactive examples

2026-03-08Rebranded to Projex — 1.0.0 shipped with OIDC publishing, no more NPM_TOKEN

2026-03-08GitHub Releases now created automatically as part of the publish pipeline

2026-03-26Officially made Projex public on Github 🎉

luke@terminal:/projects/projex$ git log --oneline -5

9121f71fix: correct Folio→Projex branding, unscoped npx commands, and CSS variable names (v1.1.4)2026-04-01T23:14:30Z

d8567b4docs: Fixing various commands and readme info2026-04-01T22:41:06Z

bea3758docs: comprehensive documentation overhaul across types, utilities, and guides2026-03-31T23:34:57Z

082fb6bdocs: update searchable-list example and add customizing search guide2026-03-11T00:36:24Z

137a4bechore(release): bump version to 1.1.32026-03-11T00:29:26Z