Search engine optimization sounds intimidating, but at its core it’s straightforward: help Google understand your content, and help users decide your site is worth visiting. This guide covers the fundamentals — straight from Google’s own documentation — with a developer’s perspective throughout.

How Google Actually Finds Your Pages

Google uses automated crawlers that constantly explore the web, following links from page to page. In most cases, you don’t need to do anything special to get indexed — if your site is live and other pages link to it, Google will find it. You can verify whether Google has already indexed your site by running a quick search:

site:yourdomain.com

If results appear, you’re in the index. If not, check that your site doesn’t have technical issues blocking crawlers — things like a misconfigured robots.txt or missing resources like CSS and JavaScript that Google needs to render your pages properly.

Tip for Next.js developers: Use the URL Inspection Tool in Google Search Console to see exactly how Google renders your pages. Server-side rendering helps here — Google sees your content immediately rather than waiting for JavaScript to execute.

URL Structure Matters More Than You Think

Parts of your URL appear directly in search results as breadcrumbs. A descriptive URL helps both users and Google understand what a page is about before they visit it.

Good: https://example.com/blog/seo-basics-for-developers

Not helpful: https://example.com/p?id=4829372

For larger sites, organizing pages into topical directories also helps Google learn how frequently different sections of your site change — which affects how often it crawls them.

Content Is Still the Most Important Signal

No amount of technical optimization will compensate for thin or unhelpful content. Google’s guidance boils down to four qualities:

• Readable and well-organized — clear headings, short paragraphs, no spelling errors
• Unique — don’t rehash what’s already out there; add genuine value
• Up-to-date — stale content hurts; review and refresh it regularly
• People-first — write for your reader, not for the crawler

Think About How Your Readers Search

Different readers use different vocabulary. A developer might search “Next.js ISR caching strategy” while a less technical reader searches “how to make my Next.js site faster.” Writing naturally — covering a topic thoroughly — gives you the best chance of matching both. Google’s language matching is sophisticated enough to connect your content to related queries even if you don’t use the exact search terms. Don’t obsess over keyword density; write clearly and comprehensively.

Title Tags and Meta Descriptions

These two elements directly influence whether someone clicks your result in Google Search.

Title Tags

Your

• Unique to the page
• Concise and clear (aim for under 60 characters)
• Descriptive of what the page actually contains

In Next.js, you can set this per-page using the generateMetadata export:

export async function generateMetadata(): Promise<Metadata> {
  return {
    title: "SEO Basics: A Developer's Guide | My Site",
  };
}

Or better yet — let an AI generate it for you based on your page content. (That’s exactly what this boilerplate does.)

Meta Descriptions

The snippet below your title link is often pulled from your meta description. A good one is:

• 1–2 sentences, under 155 characters
• Unique per page
• A genuine summary of the page’s most relevant content

export async function generateMetadata(): Promise<Metadata> {
  return {
    title: "SEO Basics: A Developer's Guide | My Site",
    description: "Learn the fundamentals of SEO from a developer's perspective — crawling, indexing, titles, meta descriptions, and more.",
  };
}

Images and Alt Text

Images are a significant discovery channel — many users find sites through Google Image Search. Two things matter most: Place images near relevant text — Google uses surrounding content to understand what an image depicts Write descriptive alt text — this is the single most important thing you can do for image SEO

<!-- Bad -->
<img src="chart.png" alt="image" />

<!-- Good -->
<img src="chart.png" alt="Bar chart showing organic traffic growth after adding structured metadata" />

Alt text also matters for accessibility, so it’s a win on multiple fronts.

Links: Internal and External

Google discovers most new pages by following links. Internal links — links between your own pages — help Google understand your site structure and spread ranking signals across pages. When linking to external sites, make sure you trust the source. If you’re linking to something you can’t vouch for, add a rel=“nofollow” attribute to avoid associating your site’s reputation with theirs.

What NOT to Worry About

Google’s own documentation calls out several SEO myths worth dismissing:

Myth	Reality
Meta keywords tag	Google has ignored it for over a decade
Keyword stuffing	Actively hurts you — it’s a spam signal
Exact-match keywords in domain name	Negligible ranking impact
Minimum/maximum word count	No magic number — write what the topic requires
Heading order (H1, H2, H3…)	Semantic order helps screen readers, not rankings
E-E-A-T as a direct ranking factor	It’s a quality framework, not a ranking signal

Promoting Your Site

Creating great content is only half the battle — people need to find it. The most durable promotion strategies are:

• Earn links organically — publish content worth referencing
• Share on relevant communities — developer forums, newsletters, social platforms
• Cross-link your own content — internal links from established pages pass authority to new ones
• Build an email list — direct traffic is the most reliable traffic

Avoid over-promotion. Spammy link-building tactics can result in manual penalties that are difficult to recover from.

Monitoring with Search Console

Once your site is live, Google Search Console is your most important SEO tool. It shows you:

• Which queries are surfacing your pages
• Click-through rates per page
• Crawl errors and indexing issues
• Core Web Vitals scores

Set it up before you need it — the data is only collected going forward, so starting early gives you a longer baseline to work from.

The Developer’s SEO Checklist

• ✅ Site is crawlable (no robots.txt blocking Googlebot)
• ✅ Pages are server-side rendered or statically generated
• ✅ Every page has a unique <title> under 60 characters
• ✅ Every page has a unique meta description under 155 characters
• ✅ Images have descriptive alt text
• ✅ URLs are human-readable and descriptive
• ✅ Internal links connect related content
• ✅ Google Search Console is configured
• ✅ Core Web Vitals are passing
• ✅ No duplicate content issues (canonical tags set where needed)

Automate the Tedious Parts

Writing unique, well-crafted titles and descriptions for every page is one of the most impactful things you can do for SEO — and one of the most tedious. That’s exactly the problem this boilerplate solves.

NextJS AI SEO Boilerplate

By running npm run seo-gen generate, Gemini reads each of your pages and generates optimized metadata automatically, writing keyword-aware titles and descriptions that follow Google’s best practices out of the box. Check out the Quick Start guide to get it running in your project in under 5 minutes.

Based on the Google Search Central SEO Starter Guide.