On this page 6 sections
Short answer: A strong developer portfolio has a clear one-line intro, three to six real projects written as short case studies (problem, what you built, result, link), an about section, proof like reviews or GitHub, and an easy way to contact you. Put it on your own domain and set up basic SEO so your name ranks on Google.
My website is my portfolio, and it brings me clients every month. Here is what I learned building it.
What to include
1. A clear intro
Who you are, what you build and who for, in one or two sentences. “Freelance software engineer in Karachi building fast websites and WordPress plugins for small businesses” beats “Passionate developer who loves coding”.
2. Projects as case studies
For each project:
- The problem or goal
- What you built and the tools you used
- Your role, if it was a team
- The result: speed, sales, time saved, grades, users
- Live link and GitHub link
- One or two screenshots
Quality beats quantity. Three great projects beat fifteen tutorial clones. See how I present mine on tech projects and websites.
3. Social proof
Client reviews, LinkedIn recommendations, GitHub activity, certificates and any numbers you can share.
4. About section
A short, human story. People hire people.
5. Contact
Email, WhatsApp or LinkedIn, visible on every page. Don’t hide it behind a long form.
6. A blog (optional, powerful)
Writing about what you build shows expertise and helps you rank for more searches. It is the reason this site appears for topics beyond my name.
Design tips
- Fast and mobile friendly. Developers are judged on their own site’s speed.
- Simple layout, generous spacing, readable fonts
- Your personality in the details, but don’t let animations hide the content
Build it with what you want to be hired for
- Front-end developer? Hand-code it or use React/Next.js.
- WordPress developer? Build it in WordPress with a custom theme.
- Designer? Show off your design system.
Personal SEO: make your name rank
Want people who search your name to find you, not someone else?
- Use your own domain, ideally your name or brand
- Put your full name in the homepage title and H1 or intro
- Write an About page and an FAQ that answer “Who is [your name]?”
- Add Person schema with links to LinkedIn, GitHub and other profiles (
sameAs) - Use the same name, photo and bio everywhere online
- Link to your site from every profile
- Submit the site to Google Search Console (guide)
This is the same approach that helps AI assistants recognise you as a person (what GEO is).
Common mistakes
- Only tutorial projects
- Broken live links
- No contact details
- Slow, heavy pages
- Walls of skills logos with no proof
Frequently asked questions
Do I need a portfolio website if I have GitHub?
GitHub shows code; a portfolio shows results and tells your story. Clients and many recruiters prefer a portfolio.
What projects should I put in my portfolio?
Real projects for real users first, then projects that solve real problems. Avoid copies of popular tutorials.
Should I use a template?
A template is fine to start, but customise it heavily. A unique, fast site is itself proof of skill.
How do I get my portfolio to rank on Google?
Own your domain, use your name in titles and headings, add Person schema, link all your profiles to it and publish helpful content.
Written by Syed Imran Murtaza
Freelance software engineer and web developer in Karachi, Pakistan (also known as CtrlAltImran). I build websites, web apps, custom WordPress plugins and AI tools for clients worldwide. About me · Hire me · My work