Skip to content

SEO: free tools, comparison pages and the SEO.md playbook - #32

Merged
hiabhee merged 3 commits into
mainfrom
feat/generator-and-alternatives
Nov 7, 2026
Merged

hiabhee merged 3 commits into
mainfrom
feat/generator-and-alternatives

Conversation

@hiabhee

@hiabhee hiabhee commented Nov 7, 2026

Copy link
Copy Markdown
Owner

Summary

Free tools

Each page is one distinct, working tool. Near-identical pages aimed at keyword variants would count as doorway pages under Google's spam policies.

Page What it does
/free-architecture-diagram-generator Describe a system or paste a GitHub repo; the editor opens and generates it (/editor?generate=). It has six one-click example prompts. /ai-architecture-diagram-generator redirects here permanently (308), so "free" and "AI" searches share one page.
/free-diagram-generator Mermaid text in, a laid-out diagram out, through the real pipeline: POST /api/diagram/load with dryRun and preview stores nothing and is limited to 300 requests an hour. Clean or hand-drawn style, PNG or SVG download, and Edit in ArchDraw, which saves a session and opens /editor?session=. The SVG is shown as an <img>, so nothing in it can run as script.
/system-design-calculator Back-of-the-envelope estimator for requests per second, peak load, reads and writes, storage and bandwidth. The maths lives in the pure, tested lib/site/capacityEstimate.ts. It has example presets, latency and powers-of-two tables, and links to glossary terms.

Comparison pages

/alternatives plus pages for Eraser, draw.io and Lucidchart. Each has an at-a-glance table, "What they do well", "What ArchDraw does differently", "Choose them if" and "Choose ArchDraw if", an FAQ (FAQPage), and a prompt box.

  • I checked current features before writing. All three products now have AI generation, so no page claims otherwise.
  • Prices and quotas are left out and linked instead, because they change often. One row I couldn't verify was removed.
  • Each page shows "Checked November 2026".

SEO.md

A playbook and case study of every SEO technique applied so far, with a change log by PR, written so the steps can be repeated on other sites. AGENTS.md points to it.

Also: sitemap entries, robots.txt allows and footer links for every new page.

Base: feat/system-design-glossary (#31). Merge in order: #28, #29, #30, #31, then this.

Test plan

  • Full frontend suite: 247 files, 1,847 tests pass; tsc and eslint clean
  • /api/diagram/load draws the tool's example in both styles, the SVG contains no <script>, and Edit in ArchDraw gets a session id
  • /ai-architecture-diagram-generator returns 308 to the new URL; all new pages return 200 (480–650 words)
  • In the browser, on the preview: draw a diagram, download PNG and SVG, open it in the editor; change the calculator inputs. Local browser checks were blocked by a dev-server reload loop: two next dev processes share .next.

Free tools, one distinct tool per page (near-duplicate keyword pages
would be doorway pages):
- /free-architecture-diagram-generator: describe a system or paste a
  GitHub repo; opens the editor generating it. /ai-architecture-diagram-
  generator redirects here (308) so "free" and "AI" searches share one page.
- /free-diagram-generator: Mermaid text to a laid-out diagram through the
  real pipeline (dry-run preview, nothing stored), PNG/SVG download,
  "Edit in ArchDraw". SVG shown as <img> so it cannot run script.
- /system-design-calculator: QPS, peak, storage and bandwidth estimates
  (pure, tested lib/site/capacityEstimate.ts), latency and powers-of-two
  tables, links into the glossary.

Comparisons: /alternatives and Eraser, draw.io, Lucidchart pages with an
at-a-glance table, "Choose them if" / "Choose ArchDraw if" and FAQ.
Claims limited to public facts checked 2026-11-07; prices left out.

Sitemap, robots allow and footer links for all of them.
Every SEO technique applied so far (audit, metadata and canonicals,
crawling and structured data, intent mapping, server-rendered content,
written guides, glossary, internal linking, free tools, comparisons,
quality gates, measurement checklist, lessons) with a change log by PR,
written to be replicated on other sites. AGENTS.md points to it.
@vercel

vercel Bot commented Nov 7, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
arch-draw Ready Ready Preview Nov 7, 2026 2:51pm UTC

@coderabbitai

coderabbitai Bot commented Nov 7, 2026 •

Copy link
Copy Markdown

Important

  • Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

Run configuration

  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: defaults
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: fcda9987-dc27-465d-a122-929b547f5db1
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

@hiabhee
hiabhee changed the base branch from feat/system-design-glossary to main November 7, 2026 15:16
@hiabhee hiabhee closed this Nov 7, 2026
@hiabhee hiabhee reopened this Nov 7, 2026
@hiabhee
hiabhee merged commit 9111b65 into main Nov 7, 2026
6 checks passed
@hiabhee
hiabhee deleted the feat/generator-and-alternatives branch November 7, 2026 15:23

This branch was successfully deployed

1 active deployment
Preview — 48d299ff Deployed Nov 7, 2026 by vercel[bot]
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