GeoHarness

geoharness.toml reference

GeoHarness reads one file, geoharness.toml, from your site directory. Keys are camelCase, unknown keys are errors, and policy choices such as Content Signals are never defaulted.

Updated · Source: docs/config.md

Which keys does geoharness.toml accept?

geoharness.toml keys
KeyTypeRequiredDefault (reason)Validation
site.originstringyes—https://host[:port], no path, query or trailing slash
site.namestringyes—non-empty, single line (it is the llms.txt H1)
site.languagestringyes—BCP 47 tag (en, en-US)
identity.kind"person" | "organization"yes—
identity.namestringyes—non-empty, single line
identity.urlstringyes—absolute http(s) URL
identity.sameAsstring[]no[] (no profiles is a valid statement, not an assumption)absolute http(s) URLs; injected as rel=me and JSON-LD sameAs
identity.organizationtable { name, url }noabsent (a person need not belong to one)both keys required when present
contentSignal.searchboolyes— (a policy choice; never defaulted)
contentSignal.aiInputboolyes—
contentSignal.aiTrainboolyes—
botsarray of tablesyes—at least one; a token may appear in only one policy (case-insensitive)
bots[].tokensstring[]yes—user-agent tokens, no whitespace or :; * allowed
bots[].group"search" | "user" | "training" | "other"yes—search/user tokens are checked by the audit's blocking robots check
bots[].allowstring[]no[] (a group may be disallow-only)each starts with / or *
bots[].disallowstring[]no[] (a group may be allow-only)each starts with / or *
content.mainSelectorstringyes—valid CSS selector; when a page has no match its <body> is used with a page.no_main warning
content.excludestring[]no[] (excluding nothing changes nothing)route globs starting with /
llms.summarystringyes—single line (the llms.txt blockquote)
llms.sectionsarray of tablesyes—may be empty ([]) for an llms.txt with no sections
llms.sections[].titlestringyes—single line (an H2)
llms.sections[].routesstring[]yes—route globs starting with /
envstring[]no[] (no template may read the environment unless a name is declared)[A-Z_][A-Z0-9_]*, unique
headers.immutablestring[]no[] (no asset is assumed to be content-hashed)Cloudflare _headers URL patterns starting with /
prerendertablenoabsent (only sites built with a prerender adapter need it)
prerender.routesstring[]yes, when [prerender] is present—literal absolute routes (no globs, query or fragment); read by the host's vite-prerender adapter, validated by the core

Globs

content.exclude and llms.sections[].routes are matched against page routes: * matches within one path segment, ** across segments, everything else is literal (/blog/**, /docs/*/).

headers.immutable entries are written verbatim as _headers URL patterns, so * there is Cloudflare's splat, which crosses /.

Templates

Page HTML and adapter-supplied markdown may contain {{geo.build_id}}, {{geo.lastmod}} and {{env.NAME}} (whitespace inside the braces is allowed). NAME must be listed in env; reading an undeclared name is an error, never an empty string. Other {{...}} text is left untouched.

Example

This site's own configuration, which GeoHarness uses to build what you are reading:

# GeoHarness builds, audits and deploys its own site with this file (see .github/workflows/deploy.yml).

[site]
origin = "https://geo.avarok.net"
name = "GeoHarness"
language = "en"

[identity]
kind = "organization"
name = "Avarok Cybersecurity"
url = "https://avarok.net"
sameAs = ["https://github.com/Avarok-Cybersecurity"]

# An open-source tool's documentation is meant to be found, quoted and learned:
# search, answers and training all help people use it correctly.
[contentSignal]
search = true
aiInput = true
aiTrain = true

[[bots]]
group = "search"
tokens = ["Googlebot", "Bingbot", "OAI-SearchBot", "Claude-SearchBot", "PerplexityBot"]
allow = ["/"]

[[bots]]
group = "user"
tokens = ["ChatGPT-User", "Claude-User", "Perplexity-User"]
allow = ["/"]

[[bots]]
group = "training"
tokens = ["GPTBot", "ClaudeBot", "Google-Extended", "Applebot-Extended", "CCBot"]
allow = ["/"]

[[bots]]
group = "other"
tokens = ["*"]
allow = ["/"]

[content]
mainSelector = "main"

[llms]
summary = "GeoHarness is a GitHub Action that builds any website, serves markdown twins to AI agents for free on Cloudflare, gates on a GEO score and Lighthouse 100, deploys and verifies the live site."

[[llms.sections]]
title = "Docs"
routes = ["/docs/**"]

[[llms.sections]]
title = "Project"
routes = ["/", "/citations/"]