devlog · 2026-07-12 · 5 min
Designing a portfolio as a product
Why selected work, disclosure, and visitor intent matter more than a gallery of screens.
A portfolio has a job
A professional site is not an autobiography with navigation. It helps a specific visitor decide whether an engineer can solve a meaningful problem. That changes the information hierarchy: selected work and decision-making come before an exhaustive technology list.
Evidence needs context
A screenshot cannot explain a constraint, a technical decision, or the part one person actually owned. Case studies should connect situation, constraint, decision, execution, outcome, and learning. When outcomes cannot be published, the absence should be explicit rather than filled with invented metrics.
Disclosure is part of design
Enterprise work is often the strongest evidence and the least shareable. A useful disclosure system distinguishes public work, limited summaries, confidential contexts, and recreated demonstrations. Clear labels build more trust than a polished visual pretending to be a production screenshot.
Make contact the next step
Every important page should create a natural path forward: examine related work, understand experience, or start a conversation. A portfolio succeeds when it reduces uncertainty without overwhelming the visitor.
Related writing