OpenAPI Troubleshooting

Spec not found

• The path in docs.json is relative to pagesDir first, then the project root
• The file extension matches (.json or .yaml)
• The file exists and is valid JSON/YAML

No pages generated

• Make sure your spec has paths with at least one operation
• Untagged operations are grouped under Default, so missing tags do not prevent page generation

Schema rendering issues

• References: Holocron dereferences $ref values and limits deeply nested schema expansion to keep pages readable
• allOf/oneOf/anyOf: Union fields are preserved and rendered in the schema view
• Missing descriptions: Operations without a summary or description show the operationId as the title

Wrong URL prefix

12345{
  "tab": "API Reference",
  "openapi": "openapi.json",
  "openapiBase": "reference"
}