No. 00Athena referencev4.2.0 · 9 min ago
Athena is the canonical docs framework for teams who read to ship — a baseline-gridded reading surface with instant search, scroll-spy wayfinding, and a colour-true code pane. Dense where it counts, calm everywhere else.
01import Compendium from './Compendium';02 03export default function DocsPage() {04 return (05 <Compendium06 version='4.2.0'07 />08 );09}No. 01Setup
One command scaffolds the reference layout, the scroll-spy rail, the colour-true code pane, and the search index into your app. No theme config, no MDX rewrite — Athena reads your existing routes.
postinstall; median query 38ms.Requiresnode ≥ 18.17react ≥ 18
npx @kintura/cli add compendium --stack=reactcontentDir: './docs'Athena indexes the tree and lifts the headings.npm run dev — ship to prod when greenScroll-spy, search, and progress wire automatically.No. 02Reference
Every endpoint is keyset-paginated, returns RFC 9457 problem details on error, and is rate-limited per token. Latencies are p50, measured us-east over the trailing 24h.
/v1/guidesReturns the active guide tree with anchors, order, and freshness metadata. Cursor-paginated, 100 per page.scope guides:read
41mshttps://api.athena.dev/v1/guides200 OK · 41ms{ "object": "list", "data": [ { "id": "gd_install", "title": "Install", "anchors": 6, "updated": "9m ago" } ], "has_more": true, "next_cursor": "eyJpZCI6Imd"}/v1/examples/runExecutes a sandboxed snippet and streams structured diagnostics. 30s wall-clock ceiling.scope examples:run
212mshttps://api.athena.dev/v1/examples/run201 Created · 212ms{ "id": "run_8fK2", "status": "passed", "duration_ms": 184, "logs": 3, "exit_code": 0}/v1/sections/:idUpdates a documentation section while preserving canonical heading ids. Partial bodies allowed.scope sections:write
63mshttps://api.athena.dev/v1/sections/:id200 OK · 63ms{ "id": "sec_42", "heading_id": "reference", "revision": 18, "updated_by": "ci@athena.dev"}/v1/searchFull-text search across the indexed corpus. Returns ranked hits with highlighted spans.scope guides:read
38mshttps://api.athena.dev/v1/search200 OK · 38ms{ "query": "scroll spy", "hits": 4, "took_ms": 38, "results": [{ "section": "reference", "score": 0.91 }]}/v1/sections/:idSoft-deletes a section and queues its anchors for redirect. Reversible for 30 days.scope sections:write
57mshttps://api.athena.dev/v1/sections/:id202 Accepted · 57ms{ "id": "sec_42", "deleted": true, "restorable_until": "2026-07-17", "redirect_queued": true}https://api.athena.devFull OpenAPI spec →No. 03Release health
Athena reference channel · 9 min ago
137 of 140 endpoints indexed
421 checks green · 0 failing
No. 05Doc feedback
No. 04Ready state
Wired in roughly 5 minutes — one component, zero runtime config, search and scroll-spy on by default. From here it is your prose and our wayfinding.
npx @kintura/cli add compendium --stack=react