SEO 21 Oct 2025 · 3 min read

SEO for Developer Portfolios: A Practical Guide

Make your developer portfolio findable: structured data, correct meta tags, fast Core Web Vitals, and the on-page basics that get you ranked and clicked.

Mossalli Al Mamun

Senior Mobile App Engineer

SEO for Developer Portfolios: A Practical Guide

A developer portfolio that nobody can find does no work for you. The good news is that portfolios are among the easiest sites to rank well — they’re small, content is genuine, and you control every byte. Here’s the practical checklist I apply, in priority order.

Get the Meta Basics Right

Search engines and social cards read your <head>. Miss these and you leave clicks on the table:

A unique, descriptive <title> per page — not “Home” on every route.
A <meta name="description"> between 120 and 160 characters that reads like ad copy.
Open Graph and Twitter tags so shared links render a real preview instead of a bare URL.
A <link rel="canonical"> to prevent duplicate-content splits when a page is reachable via multiple URLs.

<title>Mossalli Al Mamun — Senior Flutter & React Native Engineer</title>
<meta name="description"
      content="Senior mobile engineer building Flutter and React Native apps with clean architecture, WooCommerce integrations, and AI-assisted delivery." />
<link rel="canonical" href="https://launchwithmamun.com/" />
<meta property="og:title" content="Mossalli Al Mamun — Mobile App Engineer" />
<meta property="og:image" content="https://launchwithmamun.com/og.png" />
<meta name="twitter:card" content="summary_large_image" />

In Astro this belongs in a shared layout component so every page inherits it, with props to override per page.

Add Structured Data

Structured data (JSON-LD) tells Google exactly who you are, which can earn rich results and knowledge-panel treatment. For a portfolio, a Person schema is the highest-value one:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Person",
  "name": "Mossalli Al Mamun",
  "jobTitle": "Senior Mobile App Engineer",
  "url": "https://launchwithmamun.com",
  "knowsAbout": ["Flutter", "React Native", "WooCommerce", "Clean Architecture"],
  "sameAs": [
    "https://github.com/launchwithmamun",
    "https://www.linkedin.com/in/launchwithmamun"
  ]
}
</script>

For blog posts, add BlogPosting with headline, datePublished, and author. Validate everything with Google’s Rich Results Test before shipping — a malformed block silently gets ignored.

Win Core Web Vitals

Since page experience became a ranking signal, performance is SEO. The three metrics that matter:

LCP (Largest Contentful Paint) — Keep it under 2.5s. Usually your hero image or heading. Preload the hero, serve modern formats (AVIF/WebP), and set explicit width/height.
INP (Interaction to Next Paint) — Under 200ms. Ship less JavaScript; a static portfolio rarely needs a heavy framework at runtime.
CLS (Cumulative Layout Shift) — Under 0.1. Reserve space for images, ads, and web fonts so nothing jumps.

Astro is a strong choice here because it ships zero JavaScript by default and hydrates only the islands you opt into. Lean on that: most portfolio pages should be pure HTML and CSS.

Practical Performance Wins

Use astro:assets (<Image />) so images are optimized and correctly sized at build time.
Self-host fonts with font-display: swap and preload the primary weight.
Generate a sitemap.xml and reference it in robots.txt.
Compress and cache aggressively; a portfolio is static, so long cache headers are safe.

Content Is Still the Foundation

Technical polish amplifies content but can’t replace it. Ranking follows genuine, specific writing:

Write posts that answer real questions you’ve solved — “WooCommerce checkout in Flutter” beats “My thoughts on mobile.”
Use one clear <h1> per page and a logical heading hierarchy.
Add descriptive alt text to images; it helps both accessibility and image search.
Earn links naturally by publishing things worth linking to.

Measure, Don’t Guess

Wire up Google Search Console on day one — it shows the exact queries you rank for and any indexing errors. Pair it with PageSpeed Insights for field Core Web Vitals data. Together they turn SEO from superstition into a feedback loop.

SEO for a portfolio isn’t a dark art. It’s disciplined basics: honest meta tags, valid structured data, fast pages, and content that actually helps someone. Nail those, keep an eye on Search Console, and your work starts finding the people who should be hiring you.

Tags: #seo #portfolio #core-web-vitals #structured-data #performance