A portfolio isn’t a list of repos. It’s a narrative that says: “I can build things people use, I work well with others, and I’m current with technology.” Here’s how to build that narrative piece by piece.
The Portfolio Equation
Strong Portfolio = Projects (deployed) + Contributions (OSS) + Content (blogs) + Proof (certificates/awards)You need all four. Each reinforces the others.
Projects: The Core (3-5 is enough)
Follow the quality over quantity framework:
- One AI project – shows you’re current. Build with agentic AI or MCP
- One full-stack app – shows you can ship end-to-end. Build at a hackathon
- One open source contribution – shows you work with others
- One domain project – relevant to your target industry (fintech, healthtech, edtech)
Contributions: The Credibility Layer
- 3-5 merged PRs on recognizable projects
- Active issue discussions showing your thinking
- Code reviews on team projects
Read: What actually impresses employers about OSS
Content: The Amplifier
- 2-4 blog posts explaining what you built and WHY
- Read: How to start a developer blog
Proof: The Validation
- Hackathon certificates and awards (where to get them)
- Open source merge confirmations
- Deployed project links (live URLs)
How to Present It
GitHub Profile
Complete optimization guide – pin best repos, write profile README, clean up old repos.
Personal Website
One page: name, what you do, 3 project cards with links, blog link, contact. That’s it. Don’t over-design.
Each project gets a post with: problem, solution, demo video, link. Each hackathon gets a certificate post. Each blog post gets shared.
The 30-Day Portfolio Sprint
| Week | Action | Result |
|---|---|---|
| 1 | Join a hackathon, build a project | 1 deployed project |
| 2 | Polish project, write blog post about it | 1 blog post + improved project |
| 3 | Make 2 OSS contributions | 2 merged PRs |
| 4 | Set up GitHub profile + personal site | Complete portfolio live |
After 30 days you have: 1 deployed project, 1 blog post, 2 OSS PRs, optimized GitHub, personal site. That’s top 5% of applicants.