SEO — three pillars: sitemap + IndexNow + JSON-LD

decision Sat Jun 20 2026 00:00:00 GMT+0000 (Coordinated Universal Time) decisionsarchitectureseositemapindexnowjson-ldstructured-data

Decision

Every chirag127/oriz family site ships all three SEO pillars, not a subset:

Sitemap — @astrojs/sitemap generates sitemap-index.xml + sitemap-0.xml at astro build time. Submitted once per property to Google Search Console and Bing Webmaster Tools.
IndexNow — /og-style POST hook from oriz-omnipost fires the instant a new URL is published / edited / deleted. Notifies Bing
- Yandex + Seznam + Naver in milliseconds.
JSON-LD structured data — <JsonLd type="..." data={{...}} /> component in (forward reference — lands in oriz-kit's next release) emits schema.org markup for Article, BreadcrumbList, Organization, WebSite, and Person.

Submitted into both consoles — Google Search Console

Bing Webmaster Tools — which together cover Google + Bing + DuckDuckGo + Yandex.

Each pillar fixes a different failure mode; doing fewer than all three leaves a known gap.

Without a sitemap, deep pages hide behind crawl-graph hops and can sit unindexed for weeks.
Without IndexNow, new URLs wait for the next crawl (hours-days on Bing, days on Google) before they're discoverable through search.
Without JSON-LD, pages don't qualify for rich-result UIs (article cards, breadcrumb chips, sitelink search box, knowledge-panel author boxes) and AI crawlers can't reliably identify what a page is.

All three pillars are free, no-card, and stack-cohesive with the family's existing setup:

@astrojs/sitemap is a one-line addition to every site's astro.config.mjs.
IndexNow is a single POST inside oriz-omnipost's existing publish-hook loop.
<JsonLd> lives in oriz-kit, so a schema fix lands family-wide in one kit version bump.

Per-site sitemap config: astro.config.mjs declares site: (canonical URL) + the sitemap integration. The pages-mirror.yml build mirrors the dist/ output to GitHub Pages so the static-fallback mirror also has a sitemap.
Per-site IndexNow key: generated once, stored in Doppler as INDEXNOW_KEY_<sitename>, mirrored to GitHub Secrets + Cloudflare Worker secrets. The site hosts <key>.txt at the apex.
oriz-omnipost adds an IndexNowAdapter: alongside the existing dev.to / hashnode / short-link adapters. Idempotent on RSS <guid> per decisions/architecture/cross-post-engine.md.
<JsonLd> ships in oriz-kit's next release as a forward reference. Today, the component does not exist; the decision locks the contract so the kit PR is small and the sites can adopt without a contract negotiation.
Five schema types are the family-wide canon: Article, BreadcrumbList, Organization, WebSite, Person. Any additional types (e.g. Book for oriz-books, SoftwareApplication for extensions) get added per site as one-off JSON-LD blocks using the same <JsonLd> component with custom type=.
Both consoles verified at the apex oriz.in Domain property — one DNS TXT record covers every subdomain via Cloudflare DNS.
No card anywhere across the five layers. All five fit the no-card-on-file rule and the no-paid-tier rule.