Skip to content

Add JSON-LD and llms.txt for AI search - #1006

Open
halskiszymon wants to merge 4 commits into
software-mansion:mainfrom
halskiszymon:geo-structured-data
Open

Add JSON-LD and llms.txt for AI search#1006
halskiszymon wants to merge 4 commits into
software-mansion:mainfrom
halskiszymon:geo-structured-data

Conversation

@halskiszymon

Copy link
Copy Markdown

Two SEO changes for the docs site. Nothing changes the rendered page.

  • JSON-LD: Organization with the same @id as swmansion.com, plus SoftwareSourceCode. The identical @id is what makes engines read this site and swmansion.com as one entity instead of two unrelated ones.
  • llms.txt, written by an Astro integration on astro:build:done — no new dependency. The workflow fails if the file is missing or lists nothing.

Both come from swm-geo.mjs next to the Astro config. The same change is going out across the docs repos; reference: software-mansion/react-native-reanimated#10332.

Check: the deploy workflow does not run on pull requests, so the new step could not run here. It sits before the publish step, so a broken llms.txt blocks the deploy rather than shipping silently. The equivalent step is green in the Docusaurus repos, listing 25 to 90 pages.

An Astro integration writes llms.txt from the pages just built, and the same
module supplies Organization and SoftwareSourceCode structured data using the
same @id as swmansion.com. The workflow fails if the file is missing or empty.
@halskiszymon
halskiszymon marked this pull request as ready for review August 20, 2026 10:11
Comment thread landing/swm-geo.mjs
sameAs: [
"https://github.com/software-mansion",
"https://www.linkedin.com/company/software-mansion/",
"https://twitter.com/swmansion",

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

not sure if it matters

Suggested change
"https://twitter.com/swmansion",
"https://x.com/swmansion",

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.

2 participants