Skip to content

SEO, structured data and sharing assets #30

Closed
Closed
SEO, structured data and sharing assets#30
Assignees
Abuubkar
Labels
ready-for-agentSpec is complete and ready for an agent to implement

Description

@Abuubkar
Abuubkar
opened on Sep 5, 2026

Parent

Spec: #20

What to build

Everything a crawler or a shared link needs: title and description, canonical, Open Graph and Twitter tags, favicons, one static share image, and structured data.

Structured data is Organization, not LocalBusiness. The local-business types exist for places people visit and effectively require a postal address to earn rich results; with only region and country publishable, they would be both wrong and ineffective. The brand is Execile; the registered entity appears as legalName.

Fields without real values are omitted, never placeholdered — structured data carrying a bracketed placeholder is worse than an absent field, because it can be flagged.

The share image is a hand-made static asset. A build-time generator would be a rendering pipeline and two dependencies to produce one file that never changes.

robots.txt and sitemap.xml hard-code the domain, so they are written at provisioning rather than now.

Acceptance criteria

  • Title, description, canonical, and the full Open Graph and Twitter tag set render from Messages on the root route
  • The share image URL is absolute, built from the site URL variable
  • A 1200×630 share image, favicon and touch icon are committed
  • Organization JSON-LD with name Execile and legalName the registered entity
  • The postal address carries region and country only
  • telephone and sameAs are omitted while no real values exist
  • The JSON-LD validates against a structured-data testing tool
  • The site ships indexable
  • robots.txt and sitemap.xml are present with the domain left as an explicit provisioning placeholder
  • The canvas's landmark structure is preserved: one h1, section headings as h2, each section labelled by its heading

Blocked by

Activity

  1. Abuubkar
    added
    ready-for-agentSpec is complete and ready for an agent to implement
    on Sep 5, 2026
  2. Abuubkar
    added a parent issue on Sep 5, 2026
  3. Abuubkar
    changed the title [-]Footer[/-] [+]SEO, structured data and sharing assets[/+] on Sep 5, 2026
  4. Abuubkar
    marked this as blocked on Sep 5, 2026
  5. Abuubkar
    marked this as blocking on Sep 5, 2026
  6. Abuubkar
    self-assigned this
    on Sep 5, 2026

  7. Abuubkar commented on Sep 5, 2026

    @Abuubkar
    Abuubkar
    on Sep 5, 2026
    OwnerAuthor

    Done on branch ticket/30-seo.

    Structured data

    Organization, not LocalBusiness — the local-business types need a postal address to earn rich results, and only region and country are publishable. Verified from the served page:

    @type: Organization
name: Execile  /  legalName: EXECIL PVT LTD
address keys: ['@type', 'addressRegion', 'addressCountry']
telephone present: False
sameAs present: False

    Both absent fields are omitted, not placeholdered — structured data carrying [phone] is worse than no field, since Google can flag it.

    The OG image

    Generated once by scripts/og-image.py and committed; not a build step. It renders in the canvas's language with the same two headline emphases.

    The first render overflowed the canvas — the headline ran off the right edge. It now breaks into three lines and reduces the size until the widest line clears the padding, so a copy change cannot silently produce a broken share card.

    One note: Pillow cannot read WOFF2, so the render uses the variable TTF from the same Fontshare kit. That font is gitignored and nothing converted is shipped — the site still serves the untouched WOFF2, so the licence position is unchanged.

    Domain-dependent files

    robots.txt and sitemap.xml hard-code the domain, so both carry an explicit REPLACE_AT_PROVISIONING marker and a comment. Better a visible gap than a plausible-looking wrong URL.

    Verified

    10 og: tags, 5 twitter: tags, canonical, index, follow, and all four assets serving with correct content types (image/png, image/svg+xml, text/plain, application/xml). vp check passes on 51 files.

  8. Abuubkar commented on Sep 5, 2026

    @Abuubkar
    Abuubkar
    on Sep 5, 2026
    OwnerAuthor

    Done. Organization JSON-LD with omitted rather than placeholdered fields; OG image auto-fits so copy changes cannot break it.

  9. Abuubkar
    closed this as completedon Sep 5, 2026
  10. Abuubkar
    added 3 commits that reference this issue on Sep 5, 2026

    Footer

    871d76f

    SEO, structured data and sharing assets

    cebe603

    Use the real phone number

    4836bbc
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

ready-for-agentSpec is complete and ready for an agent to implement

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions