improvement(docs): streamline API reference navigation

[waleedlatif1]

Summary

• Collapse API endpoint groups by default while keeping the active group expanded
• Add a downloadable OpenAPI 3.1 JSON specification to Getting Started

Type of Change

• Improvement

Testing

• Tested manually in the docs UI
• bun run lint
• bun run lint:check
• bun run check:audits
• bun run check:openapi
• bun run --cwd apps/docs test --run lib/openapi-download.test.ts lib/openapi-source.test.ts
• bun run --cwd apps/docs type-check

Checklist

• Code follows project style guidelines
• Self-reviewed my changes
• Tests added/updated and passing
• No new warnings introduced
• I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
docs	Ready	Preview	Sep 2, 2026 2:16am UTC

[greptile-apps]

Greptile Summary

The PR streamlines API-reference navigation and adds a downloadable, consolidated OpenAPI 3.1 document.

• Keeps only the active sidebar folder expanded by default and exposes expansion state to assistive technology.
• Merges the domain-specific API specifications into a single downloadable JSON document.
• Links the downloadable specification from the API Getting Started guide and adds focused tests.

Confidence Score: 5/5

The PR appears safe to merge.

No blocking failure remains.

Important Files Changed

Filename	Overview
apps/docs/app/openapi.json/route.ts	Adds the static docs-local endpoint that serves the consolidated OpenAPI document as a named JSON download.
apps/docs/lib/openapi-download.ts	Validates and combines domain specifications while namespacing component references and rejecting conflicting definitions.
apps/docs/components/docs-layout/sidebar-components.tsx	Collapses inactive API-reference groups by default and adds accessible expansion state.
apps/docs/content/docs/api-reference/getting-started.mdx	Documents the downloadable OpenAPI 3.1 specification.
apps/docs/lib/openapi-download.test.ts	Verifies merged paths, tags, local references, response content type, and download filename.

_{Reviews (2): Last reviewed commit: "improvement(docs): streamline API refere..." | Re-trigger Greptile}

[cubic-dev-ai]

No issues found across 5 files

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

_{Re-trigger cubic}

[waleedlatif1]

@greptile

[waleedlatif1]

@cubic-dev-ai review this PR

[cubic-dev-ai]

@cubic-dev-ai review this PR

@waleedlatif1 I have started the AI code review. It will take a few minutes to complete.

[cubic-dev-ai]

No issues found across 5 files

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

_{Re-trigger cubic}