Machine-readable docs

Everything on this site has a machine-readable counterpart at a stable URL. An agent working on a Jx project can fetch the documentation corpus, the search index, or the schemas themselves without scraping HTML — and none of it is a separate artifact that drifts, because all of it is regenerated from the same sources on every build.

The documentation corpus

llms.txt

https://jxsuite.com/llms.txt

A plain-text index in the llms.txt convention : a one-paragraph summary of the project, then one ## heading per documentation section, then one line per page in sidebar order:

# Jx Suite

> Jx Suite is a visual site builder (Jx Studio), a JSON-native component format, and a compiler that prerenders every page — working on plain files you own and publish with git. …

## Start here

- [Start here](https://jxsuite.com/docs/start/): What Jx Suite is, how to install Jx Studio, and where to go first …
- [Install Jx Studio](https://jxsuite.com/docs/start/install/): Download the Jx Studio desktop app …
- [Your first project](https://jxsuite.com/docs/start/first-project/): …

Each section's landing page comes first, then its children, exactly as the sidebar orders them.

It carries no page bodies — roughly 27 KB against full-docs.json 's ~680 KB — which makes it the cheap first fetch: point an agent at it, let it read the titles and descriptions, and let it pull only the pages it needs.

full-docs.json

https://jxsuite.com/docs/full-docs.json

The same corpus in the same order, with the prose included. A JSON array of objects, one per page:

This is the fetch for an agent that wants the whole thing at once — one request, no crawling, and the markdown field is the same text a contributor edits in the repository.

search-index.json

https://jxsuite.com/search-index.json

The index that powers the site's own search box, emitted by the search extension during the build. An envelope — version , engine ( "minisearch" ), the indexed fields , and per-field boost weights — wrapped around a documents array. Each document is one page or one heading-level section within a page, carrying id , collection , slug , url , title , description , heading , and text .

Reach for it when you want lookup rather than reading: it is section-granular, so a query lands on a heading instead of a whole page.

The schemas

The other machine-readable surface is the format itself. The Jx schemas are plain JSON Schema 2020-12 documents, served at the URLs that are also their canonical $id s:

Any compliant 2020-12 validator can consume them directly — there is no Jx-specific validation runtime. They are published from packages/schema through the copy map in the site's project.json , so the served documents are byte-for-byte the schemas the toolchain uses.

For work inside a project, prefer the local composed copies. jx schema writes project.schema.json and document.schema.json into the project root, merging these core schemas with the fragments each enabled extension ships and inlining every referenced resource. Those files resolve offline — no node_modules , no network, no editor configuration — and they are what jx validate checks against. The hosted URLs above are the right reference when you are outside a project or want the core format without any extension's additions — note that the hosted $paths union accepts any extension source shape it cannot see, where your project's generated copy checks the exact set your extensions provide. See Schema composition .

Related

• Working with agents — the workflow these endpoints support

• Authoring rules for agents — the briefing to hand an agent alongside them

• CLI commands — jx schema and jx validate

• Site search — how the search index is configured and emitted

• Contributing to these docs — where the corpus comes from