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:

2stars

0forks

npm:

417downloads

1.3.0version

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

ad21b13chore(release): bump version to 1.3.02026-04-16T22:47:53Z

5ddb801Modifying agent permissions2026-04-15T17:24:35Z

3b0301dchore(release): bump version to 1.2.02026-04-15T16:26:16Z

8a87459Minor agent improvements2026-04-15T13:29:34Z

1a8133dchore(release): bump version to 1.1.52026-04-14T23:58:06Z