Skip to content

Skill S17 · Vitrine — Technical SEO Audit

/technical-seo-audit

Checks that search engines can crawl, understand and correctly index a site: robots, sitemap, canonicals, metadata, structured data, social cards, redirects and duplicates — with Next.js specifics.

Before a launch or domain move, when pages are missing from the index, or when a site generates many pages from data.

Verify everything against the production build (next build && next start, or the deployed site), never the dev server. For page content and headings, run /seo-auditor. Don't promise rankings; make indexing correct.

1. One origin

  • Decide the production origin (e.g. https://example.com) and put it in one config value.
  • In Next.js set metadataBase: new URL(origin) in the root layout, so relative canonical and OG URLs resolve absolutely.
  • Grep the repo for localhost, old domains, placeholder domains and http://. None may reach production metadata, sitemaps or JSON-LD.
  • Redirect the other variants (http → https, www ↔ apex) with a single 301 hop.

2. robots.txt

  • app/robots.ts returning { rules, sitemap }. Allow the site; disallow only what is genuinely not for search (iframe-only preview routes, internal tools, search-result URLs).
  • Never use robots.txt to remove a page from the index; that needs noindex on a crawlable page.
  • Verify: curl $ORIGIN/robots.txt shows the sitemap line with the absolute production URL.

3. Sitemap

  • app/sitemap.ts built from the same data as the routes (the registry, the CMS, the database), so it can't drift.
  • Include only canonical, indexable, 200-status URLs. No query-string variants, no noindexed pages, no redirects.
  • Verify: fetch every URL in the sitemap and assert 200 and that its canonical equals itself.

4. Canonicals and duplicates

  • Every indexable page sets alternates: { canonical: path }.
  • Filtered and sorted views (?category=, ?q=, ?sort=) canonicalise to the unfiltered page, or are noindexed.
  • Preview, print and embed routes: robots: { index: false }.
  • Trailing slashes and casing are consistent; duplicates 301 to one form.

5. Metadata on generated routes

  • Use generateMetadata on dynamic routes and build title, description and canonical from the item's own data.
  • Check uniqueness: extract <title> and <meta name="description"> from every built page and count duplicates. Zero duplicate titles is the target.

6. Social cards

  • Open Graph title, description, url, siteName, type and an image of 1200×630 (app/opengraph-image.tsx with next/og), plus twitter: { card: "summary_large_image" }.
  • Verify the rendered <meta property="og:image"> is an absolute production URL and that the image returns 200 with content-type: image/png.

7. Structured data

  • Add only what is true: WebSite and Organization on the home page, BreadcrumbList on nested pages, an item type that honestly fits (e.g. SoftwareSourceCode, CreativeWork, Article, Product only if it's for sale).
  • Never invent ratings, reviews, prices or FAQ markup for content that isn't a visible FAQ.
  • Render it as <script type="application/ld+json"> with < escaped. Verify by parsing every block from the built HTML with JSON.parse and checking required fields; then spot-check in a rich-results validator.

8. Rendering and status codes

  • Important content is in the server-rendered HTML (curl the page and grep for the h1 and body text).
  • Unknown slugs return a real 404 (notFound()), not a 200 with an empty state.
  • Crawl internal links from the home page and report every non-200 and every redirect chain.

9. URL structure

  • Lowercase, hyphenated, readable, stable: /components/silk-field, not /c?id=42. Changing a URL needs a 301 from the old one.

Output

A checklist with pass/fail and evidence (the command and what it printed) for each section, then the fixes, then the same checklist re-run.

Featured

01Glassbreak ButtonA solid plate that fractures from one impact point, cracks racing outward as the shards drift apart.04Liquid GlassA capsule of glass that bends what's behind it, carries a specular highlight around its rim toward your pointer, and squashes like a drop of liquid when pressed.07Phosphor Glass ButtonA liquid-glass pill that senses you coming: its rim light turns to face the cursor and the pill leans in to meet it.08Iris ShutterAn async button with a camera iris for a status light — blades close and turn while it works, then open onto the result.
81Atmosphere CardSmoked-glass link cards: colour pooled in the corners, slow contour currents underneath, a field that leans toward you.93Eclipse Event CardAn editorial event plate with an oversized date and an orbital eclipse bleeding in from the right, alive with slow drift.94Specimen CardAn object mounted under glass: hover lifts the pane with a sweep of reflection and swings out a paper catalogue tag.
95Silk FieldDomain-warped light that pours like liquid silk, with an optional glass lens that refracts the flow under your cursor.106IsobarA living weather map — contour lines traced over a drifting pressure field, with your cursor as a system of its own.
151Prompt ComposerA chat composer where attached files tuck into its top edge like tabs in a folder — they rise from behind it when added and sink back when removed. Send turns into stop while the reply streams.157Aura FieldA writing field where colour only exists while the AI is touching your text: the edge becomes a turning band of light and the words are rewritten in place, one by one, out of a soft blur.
205Halftone CTAA tall CTA banner where slow gold paint drifts beneath a fixed halftone grid, visible only through the dots.
212Nocturne Sign-inA single quiet column on near-black with a breathing seam of frost light behind it — email, password, magic link, nothing more.222Sigil Sign-inA split sign-in whose left half grows a geometric mark from your email — the same address always draws the same sigil.
275Voices CarouselA testimonial exhibition: one large quote at a time on frosted glass, crossfading between voices without ever resizing.
279Feral TitleA brutal condensed wordmark — heartbeat in the dark, letters slam in, a gash tears through and the word bleeds.
301 components