Skip to content

SEO: real URLs, a page per route, copy for all 37 tools - #12

Merged
Deityhub merged 5 commits into
devfrom
feat/seo-integration
Oct 29, 2026
Merged

Deityhub merged 5 commits into
devfrom
feat/seo-integration

Conversation

@Deityhub

@Deityhub Deityhub commented Oct 29, 2026 •

Copy link
Copy Markdown
Owner

Search engines ignore everything after #, so all 37 tools shared one URL. This gives every page a real address and the metadata search engines and link previews read.

Path routing

  • /, /tools/, /tools/pdf/, /tools/image/, /tools/<kind>/<id>/, /licence/, /notices/; anything else is a not-found page. History API, no router dependency (routes.ts, router.tsx); links are real <a href>.
  • Old #/... links are turned into the new paths on load. Build base is now /.

A page per route (seoPlugin.ts, seo.ts)

  • 44 files: own title, description, canonical, Open Graph and Twitter tags, JSON-LD and plain text inside the page, plus 404.html (required, or Cloudflare Pages answers every unknown address with 200) and sitemap.xml (41 addresses). Social card og.png (scripts/og.ts).
  • The app keeps the head in step while moving between pages.

Tool copy

  • Title, description, intro, three points and two questions for all 37 tools (packages/tools/src/seo/), written from what each tool does and where it stops. Shown under the tool in four framed cells, hidden once a file is added. A test fails when a tool has none.

Service worker

  • Pages are kept under their folder address; cache lookups ignore Vary (a host sending Vary: Origin made every script miss its kept copy offline).

Checks

  • node scripts/seo-check.ts reads the built site like a crawler (titles, descriptions, canonicals, JSON-LD, links, sitemap, card size); check runs it, and the Docker step now checks a tool page, the sitemap and a 404.
  • 846 tests, typecheck and build pass. Tried in Chrome: deep links, clicks, back and forward, old hash links, offline reloads, and Cloudflare's runtime (real 404, redirect to the trailing slash). Not tried: Safari, Firefox, touch.

Depends on nothing; merges cleanly with the robots and badge pull requests in any order.

@github-actions

github-actions Bot commented Oct 29, 2026 •

Copy link
Copy Markdown
Contributor

@Deityhub
Deityhub merged commit 5fbfa5d into dev Oct 29, 2026
3 checks passed
@Deityhub
Deityhub deleted the feat/seo-integration branch October 29, 2026 13:09
This was referenced Oct 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant